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Avant-propos 



Ce livre est un cours de C et de C++. II s'adresse aux personnes qui ont deja quelques notions de 
programmation dans un langage quelconque. Les connaissances requises ne sont pas tres elevees 
cependant : il n'est pas necessaire d' avoir fait de grands programmes pour lire ce document. II suffit 
d' avoir vu ce qu'est un programme et compris les grands principes de la programmation. 

Ce livre est structure en deux grandes parties, traitant chacune un des aspects du C++. La premiere 
partie, contenant les chapitres 1 a 12, traite du langage C++ lui-meme, de sa syntaxe et de ses princi- 
pales fonctionnalites. La deuxieme partie quant a elle se concentre sur la bibliotheque standard C++, 
qui fournit un ensemble de fonctionnalites coherentes et reutilisables par tous les programmeurs. La 
bibliotheque standard C++ a egalement l'avantage d'utiliser les constructions les plus avancees du 
langage, et illustre done parfaitement les notions qui auront ete abordees dans la premiere partie. La 
description de la bibliotheque standard s'etend du chapitre 13 au chapitre 18. 

Si la bibliotheque standard C++ est decrite en detail, il n'en va pas de meme pour les fonctions de 
la bibliotheque C. Vous ne trouverez done pas dans ce livre la description des fonctions classiques 
du C, ni celle des fonctions les plus courantes de la norme POSIX. En effet, bien que presentes 
sur quasiment tous les systemes d' exploitation, ces fonctions sont specifiques a la norme POSIX et 
n' appartiennent pas au langage en soi. Seules les fonctions incontournables de la bibliotheque C seront 
done presentees ici. Si vous desirez plus de renseignements, reportez-vous aux specifications des 
appels systemes POSIX de 1'OpenGroup (http://www.unix-systems.org/single_unix_specification/), 
ou a la documentation des environnements de developpement et a l'aide des kits de developpement 
des systemes d' exploitation (SDK). 

Ce livre a pour but de presenter le langage C++ tel qu'il est decrit par la norme ISO 14882 
du langage C++. Cependant, bien que cette norme ait ete publiee en 1999, le texte officiel 
n'est pas librement disponible. Comme je ne veux pas cautionner le fait qu'un texte de norme 
international ne soit pas accessible a tous, je me suis rabattu sur le document du projet de 
normalisation du langage, datant du 2 decembre 1996 et intitule « Working Paper for Draft 
Proposed International Standard for Information Systems — Programming Language C++ 
(http://casteyde.christian.free.fr/cpp/cours/drafts/index.html) ». 

Notez que les compilateurs qui respectent cette norme se comptent encore sur les doigts d'une main, 
et que les informations et exemples donnes ici peuvent ne pas s'averer exacts avec certains produits. 
En particulier, certains exemples ne compileront pas avec les compilateurs les plus mauvais. Notez 
egalement que certaines constructions du langage n'ont pas la meme signification avec tous les com- 
pilateurs, parce qu'elles ont ete implementees avant que la norme ne les specifie completement. Ces 
differences peuvent conduire a du code non portable, et ont ete signalees a chaque fois dans une note. 
Le fait que les exemples de ce livre ne fonctionnent pas avec de tels compilateurs ne peut done pas 
etre considere comme une erreur, mais plutot comme une non-conformite des outils utilises, qui sera 
sans doute levee dans les versions ulterieures de ces produits. 

Apres avoir tente de faire une presentation rigoureuse du sujet, j'ai decide d'arranger le plan de ce 
livre dans un ordre plus pedagogique. II est a mon avis impossible de parler d'un sujet un tant soit 
peu vaste dans un ordre purement mathematique, e'est-a-dire un ordre ou les notions sont introduites 
une a une, a partir des notions deja connues (chaque fonction, operateur, etc. n'apparait pas avant sa 
definition). Un tel plan necessiterait de couper le texte en morceaux qui ne sont plus thematiques. 
J'ai done pris la decision de presenter les choses par ordre logique, et non par ordre de necessite 
syntaxique. 

Les consequences de ce choix sont les suivantes : 

• il faut admettre certaines choses, quitte a les comprendre plus tard ; 
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il faut lire deux fois ce livre. Lors de la premiere lecture, on voit l'essentiel, et lors de la deuxieme 
lecture, on comprend les details (de toutes manieres, je felicite celui qui comprend toutes les subfi- 
lites du C++ du premier coup). 



Enfin, ce livre est un document vivant. II est librement telechargeable sur mon site web 
(http://casteyde.christian.free.fr), ou la derniere version peut etre recuperee. Toute remarque est done 
la bienvenue. Je tacherai de corriger les erreurs que Ton me signalera dans la mesure du possible, et 
d'apporter les modifications necessaires si un point est obscur. Si vous prenez le temps de m'envoyer 
les remarques et les erreurs que vous avez pu detecter, je vous saurais gre de verifier au prealable 
qu'elles sont toujours d'actualite dans la derniere version de ce document. A cette fin, un historique 
des revisions a ete inclus en premiere page pour permettre 1' identification des differentes editions de 
ce document. 



I. Le langage C++ 

Le C++ est l'un des langages de programmation les plus utilises actuellement. II est a la fois facile 
a utiliser et tres efficace. II souffre cependant de la reputation d'etre complique et illisible. Cette 
reputation est en partie justifiee. La complexite du langage est inevitable lorsqu'on cherche a avoir 
beaucoup de fonctionnalites. En revanche, en ce qui concerne la lisibilite des programmes, tout depend 
de la bonne volonte du programmeur. 

Les caracteristiques du C++ en font un langage ideal pour certains types de projets. II est incontour- 
nable dans la realisation des grands programmes. Les optimisations des compilateurs actuels en font 
egalement un langage de predilection pour ceux qui recherchent les performances. Enfin, ce langage 
est, avec le C, ideal pour ceux qui doivent assurer la portabilite de leurs programmes au niveau des 
fichiers sources (pas des executables). 

Les principaux avantages du C++ sont les suivants : 

• grand nombre de fonctionnalites ; 

• performances du C ; 

• facilite d' utilisation des langages objets ; 

• portabilite des fichiers sources ; 

• facilite de conversion des programmes C en C++, et, en particulier, possibilite d' utiliser toutes les 
fonctionnalites du langage C ; 

• controle d'erreurs accru. 



On dispose done de quasiment tout : puissance, fonctionnalite, portabilite et surete. La richesse du 
controle d'erreurs du langage, base sur un typage tres fort, permet de signaler un grand nombre 
d'erreurs a la compilation. Toutes ces erreurs sont autant d'erreurs que le programme ne fait pas a 
l'execution. Le C++ peut done etre considere comme un « super C ». Le revers de la medaille est que 
les programmes C ne se compilent pas directement en C++ : il est courant que de simples avertisse- 
ments en C soient des erreurs blocantes en C++. Quelques adaptations sont done souvent necessaires, 
cependant, celles-ci sont minimes, puisque la syntaxe du C++ est basee sur celle du C. On remarquera 
que tous les programmes C peuvent etre corriges pour compiler a la fois en C et en C++. 

Tout le debut de cette partie (chapitres 1 a 8) traite des fonctionnalites communes au C et au C++, 
en insistant bien sur les differences entre ces deux langages. Ces chapitres presentent essentiellement 
la syntaxe des constructions de base du C et du C++. Le debut de cette partie peut done egalement 
etre considere comme un cours allege sur le langage C. Cependant, les constructions syntaxiques 
utilisees sont ecrites de telle sorte qu'elles sont compilables en C++. Cela signifie qu'elles n'utilisent 
pas certaines fonctionnalites douteuses du C. Ceux qui desirent utiliser la premiere partie comme un 
cours de C doivent done savoir qu'il s'agit d'une version epuree de ce langage. En particulier, les 
appels de fonctions non declarees ou les appels de fonctions avec trop de parametres ne sont pas 
considered comme des pratiques de programmation valables. 

Les chapitres suivants (chapitres 8 a 12) ne traitent que du C++. Le Chapitre 8 traite de la programma- 
tion orientee objet et de toutes les extensions qui ont ete apportees au langage C pour gerer les objets. 
Le Chapitre 9 presente le mecanisme des exceptions du langage, qui permet de gerer les erreurs plus 
facilement. L' identification dynamique des types sera decrite dans le Chapitre 10. Le Chapitre 1 1 pre- 
sente la notion d'espace de nommage, que Ton utilise afin d'eviter les conflits de noms entre les diffe- 
rentes parties d'un grand projet. Enfin, le Chapitre 12 decrit le mecanisme des template, qui permet 
d'ecrire des portions de code parametrees par des types de donnees ou par des valeurs constantes. 



Ces dernieres notions sont utilisees intensivement dans la bibliotheque standard C++, aussi la lecture 
complete de la premiere partie est-elle indispensable avant de s'attaquer a la deuxieme. 

Dans toute cette premiere partie, la syntaxe sera donnee, sauf exception, avec la convention suivante : 
ce qui est entre crochets (' [' et ' ] ') est facultatif. De plus, quand plusieurs elements de syntaxe sont 
separes par une barre verticale (' | '), Fun de ces elements, et un seulement, doit etre present (c'est 
un « ou » exclusif). Enfin, les points de suspension designeront une iteration eventuelle du motif 
precedent. 

Par exemple, si la syntaxe d'une commande est la suivante : 

[faclrty I sss] zer [ (kfl [, kfl [...]])] ; 

les combinaisons suivantes seront syntaxiquement correctes : 

zer; 

fac zer; 

rty zer; 

zer (kfl) ; 

sss zer (kfl, kfl, kfl, kfl) ; 

mais la combinaison suivante sera incorrecte : 

fac sss zer ( ) 

pour les raisons suivantes : 



fac et sss sont mutuellement exclusifs, bien que facultatifs tous les deux ; 
au moins un kfl est necessaire si les parentheses sont mises ; 
il manque le point virgule final. 



Rassurez-vous, il n'y aura pratiquement jamais de syntaxe aussi compliquee. Je suis sincerement 
desole de la complexite de cet exemple. 



Chapitre 1. Premiere approche du C/C++ 

Le C/C++ est un langage procedural, du meme type que le Pascal par exemple. Cela signifie que les 
instructions sont executees lineairement et regroupees en blocs : les fonctions et les procedures (les 
procedures n'existent pas en C/C++, ce sont des fonctions qui ne retournent pas de valeur). 

Tout programme a pour but d'effectuer des operations sur des donnees. La structure fondamentale est 
done la suivante : 

ENTREE DES DONNEES 
(clavier, souris, fichier, autres peripheriques) 

TRAITEMENT DES DONNEES 

SORTIE DES DONNEES 
(ecran, imprimante, fichier, autres peripheriques) 



Ces diverses etapes peuvent etre dispersees dans le programme. Par exemple, les entrees peuvent se 
trouver dans le programme meme (l'utilisateur n' a dans ce cas pas besoin de les saisir). Pour la plupart 
des programmes, les donnees en entree proviennent duflux d' entree standard, et les donnees emises 
en sortie sont dirigees vers It flux de sortie standard. Toutefois, le processus d' entree des donnees peut 
etre repete autant de fois que necessaire pendant l'execution d'un programme, et les donnees traitees 
au fur et a mesure qu'elles apparaissent. Par exemple, pour les programmes graphiques, les donnees 
sont recues de la part du systeme sous forme de messages caracterisant les evenements generes par 
l'utilisateur ou par le systeme lui-meme (deplacement de souris, fermeture d'une fenetre, appui sur 
une touche, etc.)- Le traitement des programmes graphiques est done une boucle infinie (que Ton 
appelle la boucle des messages), qui permet de recuperer les messages et de prendre les actions en 
consequence. Dans ce cas, la sortie des donnees correspond au comportement que le programme 
adopte en reponse a ces messages. Cela peut etre tout simplement d'afficher les donnees saisies, ou, 
plus generalement, d'appliquer une commande aux donnees en cours de manipulation. 

Les donnees manipulees sont stockees dans des variables, e'est-a-dire des zones de la memoire. 
Comme leur nom l'indique, les variables peuvent etre modifiees (par le traitement des donnees). Des 
operations peuvent done etre effectuees sur les variables, mais pas n'importe lesquelles. Par exemple, 
on ne peut pas ajouter des pommes a des bananes, sauf a definir cette operation bien precisement. Les 
operations dependent done de la nature des variables. Afin de reduire les risques d'erreurs de pro- 
grammation, les langages comme le C/C++ donnent un type a chaque variable (par exemple : pomme 
et banane). Lors de la compilation (phase de traduction du texte source du programme en executable), 
ces types sont utilises pour verifier si les operations effectuees sont autorisees. Le programmeur peut 
evidemment definir ses propres types. 

Le langage fournit des types de base et des operations predefinies sur ces types. Les operations qui 
peuvent etre faites sont soit l'application d'un operateur, soit l'application d'une fonction sur les 
variables. Logiquement parlant, il n'y a pas de difference. Seule la syntaxe change : 

a=2 + 3 

est done strictement equivalent a : 

a=a joute (2,3) 
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Evidemment, des fonctions utilisateur peuvent etre definies. Les operateurs ne peuvent etre que 
surcharges : il est impossible d'en definir de nouveaux (de plus, la surcharge des operateurs n'est 
faisable qu'en C++). La notion de surcharge de fonction sera decrite en detail ci-dessous, dans la 
Section 1.6.4. 

Cette premiere partie est done consacree a la definition des types, la declaration des variables, la 
construction et l'appel de fonctions, et aux entrees / sorties de base (flux d'entree / sortie standards). 



1.1. Les commentaires en C++ 

Les commentaires sont necessaires et tres simples a faire. Tout programme doit etre commente. At- 
tention cependant, trop de commentaires tue le commentaire, parce que les choses importantes sont 
noyees dans les banalites. 

II existe deux types de commentaires en C++ : les commentaires de type C et les commentaires de fin 
de ligne (qui ne sont disponibles qu'en C++). 

Les commentaires C commencent avec la sequence barre oblique - etoile. Les commentaires se ter- 
minent avec la sequence inverse : une etoile suivie d'une barre oblique. 

Exemple 1-1. Commentaire C 

/* Ceci est un commentaire C */ 

Ces commentaires peuvent s'etendre surplusieurs lignes. 

En revanche, les commentaires de fin de lignes s'arretent a la fin de la ligne courante, et pas avant. 
lis permettent de commenter plus facilement les actions effectuees sur la ligne courante, avant le 
commentaire. Les commentaires de fin de ligne commencent par la sequence constitute de deux 
barres obliques (ils n'ont pas de sequence de terminaison, puisqu'ils ne se terminent qu'a la fin de la 
ligne courante). Par exemple : 

Exemple 1-2. Commentaire C++ 

action quelconque // Ceci est un commentaire C++ 
action suivante 



1.2. Les types predefinis du C/C++ 



Le C, et encore plus le C++, est un langage type. Cela signifie que chaque entite manipulee dans les 
programmes doit disposer d'un type de donnee grace auquel le compilateur pourra verifier la validite 
des operations qu'on lui appliquera. La prise en compte du type des donnees peut apparaitre comme 
une contrainte pour le programmeur, mais en realite il s'agit surtout d'une aide a la detection des 
erreurs. 

II existe plusieurs types predefinis. Ce sont : 

• le type vide : void. Ce type est utilise pour specifier le fait qu'il n'y a pas de type. Cela a une utilite 
pour faire des procedures (fonctions ne renvoyant rien) et les pointeurs sur des donnees non typees 
(voir plus loin) ; 

les booleens : bool, qui peuvent prendre les valeurs true et false (en C++ uniquement, ils 
n' existent pas en C) ; 
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les caracteres : char ; 



les caracteres longs : wchar_t (ce n'est un type de base que pour le langage C++, mais il est 
egalement defini dans la bibliotheque standard C et est done utilisable malgre tout en C) ; 

les entiers : int ; 

les reels : float ; 

les reels en double precision : double ; 

les tableaux a une dimension, dont les indices sont specifies par des crochets (' [' et ' ] ')■ Pour les 
tableaux de dimension superieure ou egale a 2, on utilisera des tableaux de tableaux ; 

les structures, unions et enumerations (voir plus loin). 

Les types entiers (int) peuvent etre caracterises d'un des mots cles long ou short. Ces mots cles 
permettent de modifier la taille du type, e'est-a-dire la plage de valeurs qu'ils peuvent couvrir. De 
meme, les reels en double precision peuvent etre qualifies du mot cle long, ce qui augmente leur 
plage de valeurs. On ne peut pas utiliser le mot cle short avec les double. On dispose done de types 
additionnels : 

• les entiers longs : long int, ou long (int est facultatif) ; 

• les entiers courts : short int, ou short ; 

• les reels en quadruple precision : long double. 



Note : Attention ! II n'y a pas de type de base permettant de manipuler les chaines de caracteres. 
En C/C++, les chaines de caracteres sont en realite des tableaux de caracteres. Vous trouverez 
plus loin pour de plus amples informations sur les chaines de caracteres et les tableaux. 



La taille des types n'est specifiee dans aucune norme. La seule chose qui est indiquee dans la norme 
C++, e'est que le plus petit type est le type char. Les tailles des autres types sont done des multiples 
de celle du type char. De plus, les inegalites suivantes sont toujours verifiees : 

char < short int < int < long int 
float < double < long double 

ou l'operateur « < » signifie ici « a une plage de valeur plus petite ou egale que ». Cela dit, les 
tailles des types sont generalement les memes pour tous les environnements de developpement. Le 
type char est generalement code sur un octet (8 bits), le type short int sur deux octets et le type 
long int sur quatre octets. Le type int est celui qui permet de stocker les entiers au format natif du 
processeur utilise. II est done code sur deux octets sur les machines 16 bits et sur quatre octets sur 
les machines 32 bits. Enfin, la taille des caracteres de type wchar_t n'est pas specifiee et depend de 
l'environnement de developpement utilise. lis sont generalement codes sur deux ou sur quatre octets 
suivant la representation utilisee pour les caracteres larges. 

Note : Remarquez que, d'apres ce qui precede, le type int devrait etre code sur 64 bits sur les 
machines 64 bits. Le type long int devant lui etre superieur, il doit egalement etre code sur 64 bits 
ou plus. Le type short int peut alors etre sur 1 6 ou sur 32 bits. II n'existe done pas, selon la norme, 
de type permettant de manipuler les valeurs 16 bits sur les machines 64 bits si le type short int 
est code sur 32 bits, ou, inversement, de type permettant de manipuler les valeurs 32 bits si le 
type short int est code sur 16 bits. 
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Afin de resoudre ces problemes, la plupart des compilateurs brisent la regie selon laquelle le 
type int est le type des entiers natifs du processeur, et fixent sa taille a 32 bits quelle que soit 
I'architecture utilisee. Ainsi, le type short est toujours code sur 16 bits, le type int sur 32 bits et le 
type long sur 32 ou 64 bits selon que I'architecture de la machine est 32 ou 64 bits. Autrement 
dit, le type qui represente les entiers nativement n'est plus le type int, mais le type long. Cela ne 
change pas les programmes 32 bits, puisque ces deux types sont identiques dans ce cas. Les 
programmes destines aux machines 64 bits pourront quant a eux etre optimises en utilisant le 
type long a chaque fois que Ton voudra utiliser le type de donnees natif de la machine cible. Les 
programmes 16 bits en revanchent ne sont en revanche plus compatibles avec ces regies, mais 
la plupart des compilateurs actuels ne permettent plus de compiler des programmes 16 bits de 
toutes manieres. 



Les types char, wchar_t et int peuvent etre signes ou non. Un nombre signe peut etre negatif, pas un 
nombre non signe. Lorsqu'un nombre est signe, la valeur absolue du plus grand nombre representable 
est plus petite. Par defaut, les nombres entiers sont signes. Le signe des types char et wchar_t depend 
du compilateur utilise, il est done preferable de specifier systematiquement si ces types sont signes ou 
non lorsqu'on les utilise en tant que type entier. Pour preciser qu'un nombre n'est pas signe, il faut 
utiliser le mot cle unsigned. Pour preciser qu'un nombre est signe, on peut utiliser le mot cle signed. 
Ces mots cles peuvent etre intervertis librement avec les mots cles long et short pour les types entiers. 

Exemple 1-3. Types signes et non signes 

unsigned char 
signed char 
unsigned wchar_t 
signed wchar_t 
unsigned int 
signed int 
unsigned long int 
long unsigned int 

Note : Le C++ (et le C++ uniquement) considere les types char et wcharj comme les types de 
base des caracteres. Le langage C++ distingue done les versions signees et non signees de ces 
types de la version dont le signe n'est pas specifie, puisque les caracteres n'ont pas de notion 
de signe associee. Cela signifie que les compilateurs C++ traitent les types char, unsigned char 
et signed char comme des types differents, et il en est de meme pour les types wchar_t, signed 
wchar_t et unsigned wchar_t. Cette distinction n'a pas lieu d'etre au niveau des plages de valeurs 
si Ton connait le signe du type utilise en interne pour representer les types char et wcharj, mais 
elle est tres importante dans la determination de la signature des fonctions, en particulier au 
niveau du mecanisme de surcharge des fonctions. Les notions de signature et de surcharge des 
fonctions seront detaillees plus loin dans ce cours. 



Les valeurs accessibles avec les nombres signes ne sont pas les memes que celles accessibles avec les 
nombres non signes. En effet, un bit est utilise pour le signe dans les nombres signes. Par exemple, si 
le type char est code sur 8 bits, on peut coder les nombres allant de a 255 avec ce type en non signe 
(il y a 8 chiffres binaires, chacun peut valoir ou 1, on a done 2 puissance 8 combinaisons possibles, 
ce qui fait 256). En signe, les valeurs s'etendent de -128 a 127 (un des chiffres binaires est utilise pour 
le signe, il en reste 7 pour coder le nombre, done il reste 128 possibilites dans les positifs comme dans 
les negatifs. est considere comme positif. En tout, il y a autant de possibilites.). 

De meme, si le type int est code sur 16 bits (cas des machines 16 bits), les valeurs accessibles vont 
de -32768 a 32767 ou de a 65535 si l'entier n'est pas signe. C'est le cas sur les PC en mode reel 
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(c'est-a-dire sous DOS) et sous Windows 3.x. Sur les machines fonctionnant en 32 bits, le type int est 
stocke sur 32 bits : l'espace des valeurs disponibles est done 65536 fois plus large. C'est le cas sur 
les PC en mode protege 32 bits (Windows 9x ou NT, DOS Extender, Linux) et sur les Macintosh. Sur 
les machines 64 bits, le type int devrait etre 64 bits (DEC Alpha et la plupart des machines UNIX par 
exemple). 

Enfin, le type float est generalement code sur 4 octets, et les types double et long double sont souvent 
identiques et codes sur 8 octets. 

Note : On constate done que la portability des types de base est tres aleatoire. Cela signifie qu'il 
faut faire extremement attention dans le choix des types si Ton veut faire du code portable (c'est- 
a-dire qui compilera et fonctionnera sans modification du programme sur tous les ordinateurs). II 
est dans ce cas necessaire d'utiliser des types de donnees qui donnent les memes intervalles de 
valeurs sur tous les ordinateurs. La norme ISO C99 impose de definir des types portables afin de 
regler ces problemes sur toutes les architectures existantes. Ces types sont definis dans le fichier 

d'en-tete stdint.h. II s'agit des types int8_t, intl 6 t, int32_t et int64_t, et de leurs versions non 

signees uint8_t, uint16_t, uint32_t et uint64_t. La taille de ces types en bits est indiquee dans leur 
nom et leur utilisation ne devrait pas poser de probleme. 

De la meme maniere, deux representations d'un meme type peuvent etre differentes en memoire 
sur deux machines d'architectures differentes, meme a taille egale en nombre de bits. Le prob- 
leme le plus courant est I'ordre de stockage des octets en memoire pour les types qui sont stockes 
sur plus d'un octet (c'est-a-dire quasiment tous). Cela a une importance capitale lorsque des don- 
nees doivent etre echangees entre des machines d'architectures a priori differentes, par exemple 
dans le cadre d'une communication reseau, ou lors de la definition des formats de fichiers. Une 
solution simple est de toujours d'echanger les donnees au format texte, ou de choisir un mode 
de representation de reference. Les bibliotheques reseau disposent generalement des meth- 
odes permettant de convertir les donnees vers un format commun d'echange de donnees par un 
reseau et pourront par exemple etre utilisees. 



1.3. Notation des valeurs 

Les entiers se notent de la maniere suivante : 

• base 10 (decimale) : avec les chiffres de '0' a '9', et les signes '+' (facultatif) et '-'. 
Exemple 1-4. Notation des entiers en base 10 

12354, -2564 



base 16 (hexadecimale) : avec les chiffres '0' a '9' et 'A' a 'F' ou a a f (A=a=10, B=b=ll, ... 
F=f=15). Les entiers notes en hexadecimal devront toujours etre precedes de « Ox » (qui indique la 
base). On ne peut pas utiliser le signe '-' avec les nombres hexadecimaux. 

Exemple 1-5. Notation des entiers en base 16 

OxlAE 



base 8 (octale) : avec les chiffres de '0' a '7'. Les nombres octaux doivent etre precedes d'un 
(qui indique la base). Le signe '-' ne peut pas etre utilise. 
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Exemple 1-6. Notation des en tiers en base 8 

01, 0154 



Les flottants (pseudo reels) se notent de la maniere suivante : 

[signe] chiffres [ . [chif f res] ] [e I E [signe] exposant] [f] 

oil signe indique le signe. On emploie les signes '+' (facultatif) et '-' aussi bien pour la mantisse que 
pour l'exposant. 'e' ou 'e' permet de donner l'exposant du nombre flottant. L' exposant est facultatif. 
Si on ne donne pas d' exposant, on doit donner des chiffres derriere la virgule avec un point et ces 
chiffres. Le suffixe 'f' permet de preciser si le nombre est de type float ou non (auquel cas il s'agit 
d'un double). 

Les chiffres apres la virgule sont facultatifs, mais pas le point. Si on ne met ni le point, ni la mantisse, 
le nombre est un entier decimal. 

Exemple 1-7. Notation des reels 

-123. 56f, 12e-12, 2 

« 2 » est entier, « 2.f » est reel. 

Les caracteres se notent entre guillemets simples : 

'A' , ' c' , ' (' 



On peut donner un caractere non accessible au clavier en donnant son code en octal, precede du 
caractere 'V. Par exemple, le caractere 'A' peut aussi etre note '\101'. Remarquez que cette notation 
est semblable a la notation des nombres entiers en octal, et que le '0' initial est simplement remplace 
par un 'V. II est aussi possible de noter les caracteres avec leur code en hexadecimal, a l'aide de 
la notation « \xNN », ou nn est le code hexadecimal du caractere. Enfin, il existe des sequences 
d'echappement particulieres qui permettent de coder certains caracteres speciaux plus facilement. 
Les principales sequences d'echappement sont les suivantes : 

' \a' Bip sonore 

' \b' Backspace 

' \f ' Debut de page suivante 

' \r' Retour a la ligne (sans saut de ligne) 

' \n' Passage a la ligne 

'\t' Tabulation 

' \v' Tabulation verticale 



D'autres sequences d'echappement sont disponibles, afin de pouvoir representer les caracteres ayant 
une signification particuliere en C : 



w 




Le 


caractere 


\ 


V" 




Le 


caractere 


" 


\" 


Le 


caractere 


' 
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Bien qu'il n'existe pas a proprement parler de chaines de caracteres en C/C++, il est possible de 
definir des tableaux de caracteres constants utilisables en tant que chaines de caracteres en donnant 
leur contenu entre doubles guillemets : 

"Exemple de chaine de caracteres ..." 



Les caracteres speciaux peuvent etre utilises directement dans les chaines de caracteres constantes : 

"Ceci est un saut de ligne : \nCeci est a la ligne suivante." 

Si une chaine de caracteres constante est trop longue pour tenir sur une seule ligne, on peut concatener 
plusieurs chaines en les juxtaposant : 

"Ceci est la premiere chaine " "ceci est la deuxieme." 

produit la chaine de caracteres complete suivante : 

"Ceci est la premiere chaine ceci est la deuxieme." 



Note : Attention : il ne faut pas mettre de caractere nul dans une chaine de caracteres. Ce 
caractere est en effet le caractere de terminaison de toute chaine de caracteres. 



Enfin, les versions longues des differents types cites precedemment (wchar_t, long int et long double) 
peuvent etre notees en faisant preceder ou suivre la valeur de la lettre 'L'. Cette lettre doit preceder la 
valeur dans le cas des caracteres et des chaines de caracteres et la suivre quand il s'agit des entiers et 
des flottants. Par exemple : 



L"Ceci est une chaine de wchar_t . " 
2.3e5L 



1.4. La definition des variables 

Les variables simples peuvent etre definies avec la syntaxe suivante : 

type identif icateur; 

ou type est le type de la variable et identif icateur est son nom. II est possible de creer et 
d' initialiser une serie de variables des leur creation avec la syntaxe suivante : 

type identif icateur [=valeur] [ , identif icateur [=valeur ][...]] ; 
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Exemple 1-8. Definition de variables 

int i=0, j=0; /* Definit et initialise deux entiers a */ 
double somme; /* Declare une variable reelle */ 

Les variables peuvent etre definies quasiment n'importe oil dans le programme. Cela permet de ne 
definir une variable temporaire que la ou Ton en a besoin. 

Note : Cela n'est vrai qu'en C++. En C pur, on est oblige de definir les variables au debut des 
fonctions ou des instructions composees (voir plus loin). II faut done connaitre les variables tem- 
poraires necessaires a I'ecriture du morceau de code qui suit leur definition. 



La definition d'une variable ne suffit pas, en general, a l'initialiser. Les variables non initialisees 
contenant des valeurs aleatoires, il faut eviter de les utiliser avant une initialisation correcte. Initialiser 
les variables que Ton declare a leur valeur par defaut est done une bonne habitude a prendre. Cela est 
d'ailleurs obligatoire pour les variables « constantes » que Ton peut declarer avec le mot cle const, 
car ces variables ne peuvent pas etre modifiees apres leur definition. Ce mot cle sera presente en detail 
dans la Section 3.2. 

Note : Si les variables utilisant les types simples ne sont pas initialisees lors de leur definition 
de maniere generale, ce n'est pas le cas pour les objets dont le type est une classe definie 
par I'utilisateur. En effet, pour ces objets, le compilateur appelle automatiquement une fonction 
d'initialisation appelee le « constructeur » lors de leur definition. La maniere de definir des classes 
d'objets ainsi que toutes les notions traitant de la programmation objet seront decrites dans le 
Chapitre 8. 



La definition d'un tableau se fait en faisant suivre le nom de l'identificateur d'une paire de crochets, 
contenant le nombre d' element du tableau : 

type identif icateur [taille] ( [taille] (...)); 



Note : Attention ! Les caracteres ' [' et '] ' etant utilises par la syntaxe des tableaux, ils ne signifient 
plus les elements facultatifs ici. Ici, et ici seulement, les elements facultatifs sont donnes entre 
parentheses. 



Dans la syntaxe precedente, type represente le type des elements du tableau. 

Exemple 1-9. Definition d'un tableau 

int MonTableau [100] ; 

MonTableau est un tableau de 100 entiers. On reference les elements des tableaux en donnant l'indice 
de 1' element entre crochet : 

MonTableau [3] =0; 
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Note : La syntaxe permettant d'initialiser les tableaux des leur creation est un peu plus complexe 
que celle permettant d'initialiser les variables de type simple. Cette syntaxe est semblable a celle 
permettant d'initialiser les structures de donnees et sera done decrite dans la section qui leur est 
dediee. 



En C/C++, les tableaux a plus d'une dimension sont des tableaux de tableaux. On prendra garde au 
fait que dans la definition d'un tableau a plusieurs dimensions, la derniere taille indiquee specifie la 
taille du tableau dont on fait un tableau. Ainsi, dans l'exemple suivant : 

int Matrice [5] [ 4 ] ; 

Matrice est un tableau de taille 5 dont les elements sont eux-memes des tableaux de taille 4. L'ordre 
de declaration des dimensions est done inverse : 5 est la taille de la derniere dimension et 4 est la taille 
de la premiere dimension. L' element suivant : 

Matrice[2] ; 

est done le troisieme element de ce tableau de taille cinq, et est lui-meme un tableau de quatre ele- 
ments. 

En C/C++, les indices des tableaux varient de a taille-1, II y a done bien taille elements dans 
le tableau. Dans l'exemple donne ci-dessus, l'element MonTableau [100] n'existe pas : y acceder 
plantera le programme. C'est au programmeur de verifier que ses programmes n'utilisent jamais les 
tableaux avec des indices plus grands que leur taille ou negatifs. 

Un autre point auquel il faudra faire attention est la taille des tableaux a utiliser pour les chaines de 
caracteres. Une chaine de caracteres se termine obligatoirement par le caractere nul ('\0'), il faut done 
reserver de la place pour lui. Par exemple, pour creer une chaine de caracteres de 100 caracteres au 
plus, il faut un tableau pour 101 caracteres (declare avec « char chaine [101]; »). 



1 .5. Instructions et operations 



Les instructions sont generalement identifiees par le point virgule. C'est ce caractere qui marque la 
fin d'une instruction. 

Exemple 1-10. Instruction vide 

; /* Instruction vide : ne fait rien ! */ 

II existe plusieurs types d' instructions, qui permettent de realiser des operations variees. Les instruc- 
tions les plus courantes sont sans doute les instructions qui effectuent des operations, e'est-a-dire les 
instructions qui contiennent des expressions utilisant des operateurs. 

Les principales operations utilisables en C/C++ sont les suivantes : 

• les affectations : 

variable = valeur 



Note : Les affectations ne sont pas des instructions. Ce sont bien des operations qui renvoient 
la valeur affectee. On peut done effectuer des affectations multiples : 
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i=j=k=m=0; /* Annule les variables i, j, k et m. */ 



les operations de base du langage : 

valeur op valeur 

oil op est l'un des operateurs suivants : +, -, *, /, %, &, | , A , ~, <<, >>. 

Note : '/' represente la division euclidienne pour les entiers et la division classique pour les 
flottants. 



' %' represente la congruence (c'est-a-dire le reste de la division euclidienne). ' | ' et ' &' represented 
respectivement le ou et le et binaire (c'est-a-dire bit a bit : 1 et 1 = 1, et x = 0, 1 ou x = 1 et ou 
= 0). ' A ' represente le ou exclusif (1 xor 1=0, 0xor0 = Oet 1 xor 0= 1). '-' represente la negation 
binaire (1 devient et vice versa). '<<' et '>>' effectuent un decalage binaire vers la gauche et la 
droite respectivement, d'un nombre de bits egal a la valeur du second operande. 



• les operations des autres operateurs du langage. Le C et le C++ disposent d' operateurs un peu 
plus evolues que les operateurs permettant de realiser les operations de base du langage. Ces ope- 
rateurs sont les operateurs d' incrementation et de decrementation ++ et — , l'operateur ternaire 
devaluation conditionnelle d'une expression (operateur ?:) et l'operateur virgule (operateur ,). 
La syntaxe de ces operateurs est decrite ci-dessous. 

• les appels de fonctions. Nous verrons comment ecrire et appeler des fonctions dans les sections 
suivantes. 

Bien entendu, la plupart des instructions contiendront des affectations. Ce sont done sans doute les 
affectations qui sont les plus utilisees parmi les diverses operations realisables, aussi le C et le C++ 
permettent-ils F utilisation d' affectations composees. Une affectation composee est une operation per- 
mettant de realiser en une seule etape une operation normale et 1' affectation de son resultat dans la 
variable servant de premier operande. Les affectations composees utilisent la syntaxe suivante : 

variable op_aff valeur 

ou op_af f est l'un des operateurs suivants : '+=', '-=', '*=', etc. Cette syntaxe est strictement equi- 
valente a : 

variable = variable op valeur 

et permet done de modifier la valeur de variable en lui appliquant l'operateur op. 

Exemple 1-11. Affectation composee 

i*=2; /* Multiplie i par 2 : i = i * 2. */ 

Les operateurs decrementation et de decrementation ++ et — s'appliquent comme des prefixes ou 
des suffixes sur les variables. Lorsqu'ils sont en prefixe, la variable est incremented ou decrementee, 



10 
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puis sa valeur est renvoyee. S'ils sont en suffixe, la valeur de la variable est renvoyee, puis la variable 
est incremented ou decrementee. Par exemple : 

int i=2 , j , k; 

j=++i; /* A la fin de cette instruction, i et j valent 3. */ 
k=j++; /* A la fin de cette ligne, k vaut 3 et j vaut 4. */ 



Note : On prendra garde a n'utiliser les operateurs decrementation et de decrementation post- 
fixes que lorsque cela est reellement necessaire. En effet, ces operateurs doivent contruire un 
objet temporaire pour renvoyer la valeur de la variable avant incrementation ou decrementation. 
Si cet objet temporaire n'est pas utilise, il est preferable d'utiliser les versions prefixees de ces 
operateurs. 



L'operateur ternaire d' evaluation conditionnelle ? : est le seul operateur qui demande 3 parametres (a 
part l'operateur fonctionnel ( ) des fonctions, qui admet n parametres, et que Ton decrira plus tard). 
Cet operateur permet de realiser un test sur une condition et de calculer une expression ou une autre 
selon le resultat de ce test. La syntaxe de cet operateur est la suivante : 

test ? expression! : expression2 



Dans cette syntaxe, test est evalue en premier. Son resultat doit etre booleen ou entier. Si test est 
vrai (ou si sa valeur est non nulle), expressionl est calculee et sa valeur est renvoyee. Sinon, c'est 
la valeur de expression2 qui est renvoyee. Par exemple, l'expression : 

Min= (i<j) ?i: j ; 

calcule le minimum de i et de j. 

L'operateur virgule, quant a lui, permet d'evaluerplusieurs expressions successivement et de renvoyer 
la valeur de la derniere expression. La syntaxe de cet operateur est la suivante : 

expressionl , express ion2 [, express ion3 [ . . .] ] 

ou expressionl, expression2, etc. sont les expressions a evaluer. Les expressions sont evaluees 
de gauche a droite, puis le type et la valeur de la derniere expression sont utilises pour renvoyer le 
resultat. Par exemple, a Tissue des deux lignes suivantes : 



double r = 5; 
int i = r*3, 1; 

r vaut 5 et i vaut 1. r*3 est calcule pour rien. 

Note : Ces deux derniers operateurs peuvent nuire gravement a la lisibilite des programmes. II est 
toujours possible de reecrire les lignes utilisant l'operateur ternaire avec un test (voir la Section 
2.1 pour la syntaxe des tests en C/C++). De meme, on peut toujours decomposer une expression 
utilisant l'operateur virgule en deux instructions distinctes. Ce dernier operateur ne devra done 
jamais etre utilise. 
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II est possible de creer des instructions composees, constitutes d' instructions plus simples. Les ins- 
tructions composees se presentent sous la forme de bloc d' instructions ou les instructions contenues 
sont encadrees d'accolades ouvrantes et fermantes (caracteres ' { et ' } '). 

Exemple 1-12. Instruction composee 

{ 

i=l; 

j=i+3*g; 



Note : Un bloc constructions est considere comme une instruction unique. II est done inutile de 
mettre un point virgule pour marquer I'instruction, puisque le bloc lui-meme est une instruction. 



Enfin, il existe tout un jeu d' instructions qui permettent de modifier le cours de l'execution du pro- 
gramme, comme les tests, les boucles et les sauts. Ces instructions seront decrites en detail dans le 
chapitre traitant des structures de controle. 



1 .6. Les fonctions 



Le C++ ne permet de faire que des fonctions, pas de procedures. Une procedure peut etre faite en 
utilisant une fonction ne renvoyant pas de valeur ou en ignorant la valeur retournee. 

1.6.1. Definition des fonctions 

La definition des fonctions se fait comme suit : 

type identif icateur (parametres) 
{ 

... /* Instructions de la fonction. */ 
} 

type est le type de la valeur renvoyee, identif icateur est le nom de la fonction, et parametres 
est une liste de parametres. La syntaxe de la liste de parametres est la suivante : 

type variable [= valeur] [, type variable [= valeur] [...]] 

ou type est le type du parametre variable qui le suit et valeur sa valeur par defaut. La valeur par 
defaut d'un parametre est la valeur que ce parametre prend si aucune valeur ne lui est attribute lors 
de l'appel de la fonction. 

Note : Linitialisation des parametres de fonctions n'est possible qu'en C++, le C n'accepte pas 
cette syntaxe. 



La valeur de la fonction a renvoyer est specifiee en utilisant la commande return, dont la syntaxe 
est : 

return valeur; 
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Exemple 1-13. Definition de fonction 

int somme (int i, int j) 
{ 

return i+j; 
} 

Si une fonction ne renvoie pas de valeur, on lui donnera le type void. Si elle n' attend pas de parametres, 
sa liste de parametres sera void ou n'existera pas. II n'est pas necessaire de mettre une instruction 
return a la fin d'une fonction qui ne renvoie pas de valeur. 

Exemple 1-14. Definition de procedure 

void rien () /* Fonction n' attendant pas de parametres */ 

{ /* et ne renvoyant pas de valeur. */ 

return; /* Cette ligne est facultative. */ 
} 



1.6.2. Appel des fonctions 

L'appel d'une fonction se fait en donnant son nom, puis les valeurs de ses parametres entre paren- 
theses. Attention ! S'il n'y a pas de parametres, il faut quand meme mettre les parentheses, sinon la 
fonction n'est pas appelee. 

Exemple 1-15. Appel de fonction 

int i=somme (2 , 3 ) ; 
rien ( ) ; 

Si la declaration comprend des valeurs par defaut pour des parametres (C++ seulement), ces valeurs 
sont utilisees lorsque ces parametres ne sont pas fournis lors de l'appel. Si un parametre est manquant, 
alors tous les parametres qui le suivent doivent eux aussi etre omis. II en resulte que seuls les derniers 
parametres d'une fonction peuvent avoir des valeurs par defaut. Par exemple : 



int test (int i = 0, int j = 2) 
{ 

return i/j; 
} 



L'appel de la fonction test (8) est valide. Comme on ne precise pas le dernier parametre, j est 
initialise a 2. Le resultat obtenu est done 4. De meme, l'appel test () est valide : dans ce cas i 
vaut et j vaut 2. En revanche, il est impossible d'appeler la fonction test en ne precisant que la 
valeur de j. Enfin, l'expression « int test(int i=0, int j) {...}» serait invalide, car si on 
ne passait pas deux parametres, j ne serait pas initialise. 



1.6.3. Declaration des fonctions 

Toute fonction doit etre declaree avant d'etre appelee pour la premiere fois. La definition d'une fonc- 
tion peut faire office de declaration. 
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II peut se trouver des situations ou une fonction doit etre appelee dans une autre fonction definie avant 
elle. Comme cette fonction n'est pas definie au moment de l'appel, elle doit etre declaree. De meme, 
il est courant d' avoir a appeler une fonction definie dans un autre fichier que le fichier d'ou se fait 
l'appel. Encore une fois, il est necessaire de declarer ces fonctions. 

Le role des declarations est done de signaler 1' existence des fonctions aux compilateurs afin de les 
utiliser, tout en reportant leur definition plus loin ou dans un autre fichier. 

La syntaxe de la declaration d'une fonction est la suivante : 

type identif icateur (parametres) ; 

ou type est le type de la valeur renvoyee par la fonction, identif icateur est son nom et para- 
metres la liste des types des parametres que la fonction admet, eventuellement avec leurs valeurs par 
defaut, et separes par des virgules. 

Exemple 1-16. Declaration de fonction 

int Min (int, int); /* Declaration de la fonction minimum */ 

/* definie plus loin. */ 
/* Fonction principale. */ 
int main (void) 
{ 

int i = Min(2,3); /* Appel a la fonction Min, deja 

declaree. */ 
return 0; 
} 

/* Definition de la fonction min. */ 

int Min (int i, int j) 

{ 

if (i<j) return i; 

else return j; 



Si Ton donne des valeurs par defaut differentes aux parametres d'une fonction dans plusieurs decla- 
rations differentes, les valeurs par defaut utilisees sont celles de la declaration visible lors de l'appel 
de la fonction. Si plusieurs declarations sont visibles et entrent en confiit au niveau des valeurs par 
defaut des parametres de la fonction, le compilateur ne saura pas quelle declaration utiliser et signa- 
lera une erreur a la compilation. Enfin, il est possible de completer la liste des valeurs par defaut de 
la declaration d'une fonction dans sa definition. Dans ce cas, les valeurs par defaut specifiees dans la 
definition ne doivent pas entrer en confiit avec celles specifiees dans la declaration visible au moment 
de la definition, faute de quoi le compilateur signalera une erreur. 



1.6.4. Surcharge des fonctions 

II est interdit en C de definir plusieurs fonctions qui portent le meme nom. En C++, cette interdiction 
est levee, moyennant quelques precautions. Le compilateur peut differencier deux fonctions en regar- 
dant le type des parametres qu'elle recoit. La liste de ces types s'appelle la signature de la fonction. 
En revanche, le type du resultat de la fonction ne permet pas de l'identifier, car le resultat peut ne pas 
etre utilise ou peut etre converti en une valeur d'un autre type avant d'etre utilise apres l'appel de cette 
fonction. 

II est done possible de faire des fonctions de meme nom (on les appelle alors des surcharges) si 
et seulement si toutes les fonctions portant ce nom peuvent etre distinguees par leurs signatures. 
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La surcharge qui sera appelee sera celle dont la signature est la plus proche des valeurs passees en 
parametre lors de l'appel. 

Exemple 1-17. Surcharge de fonctions 

float test (int i, int j) 
{ 

return (float) i+j; 
} 

float test (float i, float j) 
{ 

return i*j; 
} 

Ces deux fonctions portent le meme nom, et le compilateur les acceptera toutes les deux. Lors de 
l'appel de test (2, 3) , ce sera la premiere qui sera appelee, car 2 et 3 sontdes entiers. Lors de l'appel 
de test (2 . 5 , 3 . 2 ) , ce sera la deuxieme, parce que 2 . 5 et 3 . 2 sont reels. Attention ! Dans un appel 
tel que test ( 2 . 5 , 3 ) , le flottant 2 . 5 sera converti en entier et la premiere fonction sera appelee. II 
convient done de faire tres attention aux mecanismes de surcharge du langage, et de verifier les regies 
de priorite utilisees par le compilateur. 

On veillera a ne pas utiliser des fonctions surchargees dont les parametres ont des valeurs par defaut, 
car le compilateur ne pourrait pas faire la distinction entre ces fonctions. D'une maniere generate, le 
compilateur dispose d'un ensemble de regies (dont la presentation depasse le cadre de ce livre) qui 
lui permettent de determiner la meilleure fonction a appeler etant donne un jeu de parametres. Si, lors 
de la recherche de la fonction a utiliser, le compilateur trouve des ambigui'tes, il genere une erreur. 



1.6.5. Fonctions inline 

Le C++ dispose du mot cle inline, qui permet de modifier la methode d' implementation des fonc- 
tions. Place devant la declaration d'une fonction, il propose au compilateur de ne pas instancier cette 
fonction. Cela signifie que Ton desire que le compilateur remplace l'appel de la fonction par le code 
correspondant. Si la fonction est grosse ou si elle est appelee souvent, le programme devient plus gros, 
puisque la fonction est reecrite a chaque fois qu'elle est appelee. En revanche, il devient nettement 
plus rapide, puisque les mecanismes d' appel de fonctions, de passage des parametres et de la valeur de 
retour sont ainsi evites. De plus, le compilateur peut effectuer des optimisations additionnelles qu'il 
n'aurait pas pu faire si la fonction n'etait pas inlinee. En pratique, on reservera cette technique pour 
les petites fonctions appelees dans du code devant etre rapide (a l'interieur des boucles par exemple), 
ou pour les fonctions permettant de lire des valeurs dans des variables. 

Cependant, il faut se mefier. Le mot cle inline est un indice indiquant au compilateur de faire des 
fonctions inline. II n'y est pas oblige. La fonction peut done tres bien etre implementee classique- 
ment. Pire, elle peut etre implementee des deux manieres, selon les mecanismes d' optimisation du 
compilateur. De meme, le compilateur peut egalement inliner les fonctions normales afin d'optimiser 
les performances du programme. 

De plus, il faut connaitre les restrictions des fonctions inline : 

• elles ne peuvent pas etre recursives ; 

• elles ne sont pas instanciees, done on ne peut pas faire de pointeur sur une fonction inline. 
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Si l'une de ces deux conditions n'est pas verifiee pour une fonction, le compilateur l'implementera 
classiquement (elle ne sera done pas inline). 

Enfin, du fait que les fonctions inline sont inserees telles quelles aux endroits oil elles sont appelees, 
il est necessaire qu'elles soient completement definies avant leur appel. Cela signifie que, contraire- 
ment aux fonctions classiques, il n'est pas possible de se contenter de les declarer pour les appeler, 
et de fournir leur definition dans un fichier separe. Dans ce cas en effet, le compilateur genererait 
des references externes sur ces fonctions, et n'insererait pas leur code. Ces references ne seraient pas 
resolues a l'edition de lien, car il ne genere egalement pas les fonctions inline, puisqu'elles sont 
supposees etre inserees sur place lorsqu'on les utilise. Les notions de compilation dans des fichiers 
separes et d' edition de liens seront presentees en detail dans le Chapitre 6. 

Exemple 1-18. Fonction inline 

inline int Max(int i, int j) 
{ 

if (i>j) 

return i; 
else 

return j ; 
} 

Pour ce type de fonction, il est tout a fait justifie d'utiliser le mot cle inline. 



1.6.6. Fonctions statiques 

Par defaut, lorsqu'une fonction est definie dans un fichier C/C++, elle peut etre utilisee dans tout autre 
fichier pourvu qu'elle soit declaree avant son utilisation. Dans ce cas, la fonction est dite externe. II 
peut cependant etre interessant de definir des fonctions locales a un fichier, soit afin de resoudre des 
confiits de noms (entre deux fonctions de meme nom et de meme signature mais dans deux fichiers 
differents), soit parce que la fonction est uniquement d'interet local. Le C et le C++ fournissent done 
le mot cle static qui, une fois place devant la definition et les eventuelles declarations d'une fonc- 
tion, la rend unique et utilisable uniquement dans ce fichier. A part ce detail, les fonctions statiques 
s'utilisent exactement comme des fonctions classiques. 

Exemple 1-19. Fonction statique 

// Declaration de fonction statique : 
static int localel (void) ; 

/* Definition de fonction statique : */ 

static int locale2(int i, float j) 

{ 

return i*i+j; 



Les techniques permettant de decouper un programme en plusieurs fichiers sources et de generer les 
fichiers binaires a partir de ces fichiers seront decrites dans le chapitre traitant de la modularite des 
programmes. 
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1.6.7. Fonctions prenant un nombre variable de parametres 

En general, les fonctions ont un nombre constant de parametres. Pour les fonctions qui ont des para- 
metres par defaut en C++, le nombre de parametres peut apparaitre variable a l'appel de la fonction, 
mais en realite, la fonction utilise toujours le meme nombre de parametres. 

Le C et le C++ disposent toutefois d'un mecanisme qui permet au programmeur de realiser des fonc- 
tions dont le nombre et le type des parametres sont variables. Nous verrons plus loin que les fonctions 
d' entree / sortie du C sont des fonctions dont la liste des arguments n'est pas fixee, cela afin de pouvoir 
realiser un nombre arbitraire d'entrees / sorties, et ce sur n'importe quel type predefini. 

En general, les fonctions dont la liste des parametres est arbitrairement longue disposent d'un critere 
pour savoir quel est le dernier parametre. Ce critere peut etre le nombre de parametres, qui peut etre 
fourni en premier parametre a la fonction, ou une valeur de parametre particuliere qui determine la fin 
de la liste par exemple. On peut aussi definir les parametres qui suivent le premier parametre a l'aide 
d'une chaine de caracteres. 

Pour indiquer au compilateur qu'une fonction peut accepter une liste de parametres variable, il faut 
simplement utiliser des points de suspensions dans la liste des parametres : 

type identif icateur (parametres, ...) 

dans les declarations et la definition de la fonction. Dans tous les cas, il est necessaire que la fonction 
ait au moins un parametre classique. Les parametres classiques doivent imperativement etre avant les 
points de suspensions. 

La difficulte apparait en fait dans la maniere de recuperer les parametres de la liste de parametres dans 
la definition de la fonction. Les mecanismes de passage des parametres etant tres dependants de la 
machine (et du compilateur), un jeu de macros a ete defini dans le fichier d'en-tete stdarg.h pour 
faciliter l'acces aux parametres de la liste. Pour en savoir plus sur les macros et les fichiers d'en-tete, 
consulter le Chapitre 5. Pour l'instant, sachez seulement qu'il faut ajouter la ligne suivante : 

#include <stdarg.h> 

au debut de votre programme. Cela permet d'utiliser le type va_list et les expressions va_start, 
va_arg et va_end pour recuperer les arguments de la liste de parametres variable, un a un. 

Le principe est simple. Dans la fonction, vous devez declarer une variable de type va_list. Puis, vous 
devez initialiser cette variable avec la syntaxe suivante : 

va_start (variable, parametre); 

ou variable est le nom de la variable de type va_list que vous venez de creer, et parametre est le 
dernier parametre classique de la fonction. Des que variable est initialisee, vous pouvez recuperer 
un a un les parametres a l'aide de l'expression suivante : 

va_arg (variable, type) 

qui renvoie le parametre en cours avec le type type et met a jour variable pour passer au parametre 
suivant. Vous pouvez utiliser cette expression autant de fois que vous le desirez, elle retourne a chaque 
fois un nouveau parametre. Lorsque le nombre de parametres correct a ete recupere, vous devez 
detruire la variable variable a l'aide de la syntaxe suivante : 

va_end (variable) ; 
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II est possible de recommencer ces etapes autant de fois que Ton veut, la seule chose qui compte est 
de bien faire l'initialisation avec va_start et de bien terminer la procedure avec va_end a chaque 
fois. 

Note : II existe une restriction sur les types des parametres des listes variables d'arguments. 
Lors de I'appel des fonctions, un certain nombre de traitements a lieu sur les parametres. En 
particulier, des promotions implicites ont lieu, ce qui se traduit par le fait que les parametres 
reellement passes aux fonctions ne sont pas du type declare. Le compilateur continue de faire les 
verifications de type, mais en interne, un type plus grand peut etre utilise pour passer les valeurs 
des parametres. En particulier, les types char et short ne sont pas utilises : les parametres sont 
toujours promus aux type int ou long int. Cela implique que les seuls types que vous pouvez 
utiliser sont les types cibles des promotions et les types qui ne sont pas sujets aux promotions 
(pointeurs, structures et unions). Les types cibles dans les promotions sont determines comme 
suit : 

• les types char, signed char, unsigned char, short int ou unsigned short int sont promus en int 
si ce type est capable d'accepter toutes leurs valeurs. Si int est insuffisant, unsigned int est 
utilise ; 

• les types des enumerations (voir plus loin pour la definition des enumerations) et wchar_t 
sont promus en int, unsigned int, long ou unsigned long selon leurs capacites. Le premier type 
capable de conserver la plage de valeur du type a promouvoir est utilise ; 

• les valeurs des champs de bits sont converties en int ou unsigned int selon la taille du champ 
de bit (voir plus loin pour la definition des champs de bits) ; 

• les valeurs de type float sont converties en double. 



Exemple 1-20. Fonction a nombre de parametres variable 

#include <stdarg.h> 

/* Fonction effectuant la somme de "compte" parametres : */ 

double somme (int compte, . . . ) 

{ 

double resultat=0; /* Variable stockant la somme. */ 
va_list varg; /* Variable identifiant le prochain 

parametre. */ 
va_start (varg, compte); /* Initialisation de la liste. */ 
do /* Parcours de la liste. */ 

{ 

resultat=resultat+va_arg (varg, double) ; 
compte=compte-l ; 
} while (compte!=0); 

va_end (varg) ; /* Terminaison. */ 

return resultat; 



La fonction somme effectue la somme de compte flottants (float ou double) et la renvoie dans un 
double. Pour plus de details sur la structure de controle do ... while, voir Section 2.4. 
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1.7. La fonction main 

Lorsqu'un programme est charge, son execution commence par l'appel d'une fonction speciale du 
programme. Cette fonction doit imperativement s'appeler « main » {principal en anglais) pour que 
le compilateur puisse savoir que c'est cette fonction qui marque le debut du programme. La fonction 
main est appelee par le systeme d' exploitation, elle ne peut pas etre appelee par le programme, c'est- 
a-dire qu'elle ne peut pas etre recursive. 

Exemple 1-21. Programme minimal 

int main ( ) /* Plus petit programme C/C++. */ 

{ 

return 0; 
} 

La fonction main doit renvoyer un code d'erreur d' execution du programme, le type de ce code est 
int. Elle peut aussi recevoir des parametres du systeme d' exploitation. Ceci sera explique plus loin. 
Pour l'instant, on se contentera d'une fonction main ne prenant pas de parametre. 

Note : II est specifies dans la norme du C++ que la fonction main ne doit pas renvoyer le type void. 
En pratique cependant, beaucoup de compilateurs I'acceptent egalement. 

La valeur o retournee par la fonction main indique que tout s'est deroule correctement. En realite, 
la valeur du code de retour peut etre interpretee differemment selon le systeme d'exploitation 
utilise. La bibliotheque C definit done les constantes exit_success et exit_failure, qui perme- 
ttent de supprimer I'hypothese sur la valeur a utiliser respectivement en cas de succes et en cas 
d'erreur. 



1 .8. Les fonctions d'entree / sortie de base 

Nous avons distingue au debut de ce chapitre les programmes graphiques, qui traitent les evenements 
qu'ils recoivent du systeme sous la forme de messages, des autres programmes, qui recoivent les 
donnees a traiter et ecrivent leurs resultats sur les flux d'entree / sortie standards. Les notions de flux 
d'entree / sortie standards n'ont pas ete definies plus en detail a ce moment, et il est temps a present 
de pallier cette lacune. 

1.8.1. Generalites sur les flux d'entree / sortie en C 

Un flux est une notion informatique qui permet de representer un Hot de donnees sequentielles en 
provenance d'une source de donnees ou a destination d'une autre partie du systeme. Les flux sont 
utilises pour uniformiser la maniere dont les programmes travaillent avec les donnees, et done pour 
simplifier leur programmation. Les fichiers constituent un bon exemple de flux, mais ce n'est pas le 
seul type de flux existant : on peut traiter un flux de donnees provenant d'un reseau, d'un tampon 
memoire ou de toute autre source de donnees ou partie du systeme permettant de traiter les donnees 
sequentiellement. 

Sur quasiment tous les systemes d'exploitation, les programmes disposent des leur lancement de trois 
flux d'entree / sortie standards. Generalement, le flux d'entree standard est associe au flux de donnees 
provenant d'un terminal, et le flux de sortie standard a la console de ce terminal. Ainsi, les donnees 
que l'utilisateur saisit au clavier peuvent etre lues par les programmes sur leur flux d'entree standard, 
et ils peuvent afficher leurs resultats a 1'ecran en ecrivant simplement sur leur flux de sortie standard. 
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Le troisieme flux standard est le flux d'erreur standard qui, par defaut, est egalement associe a l'ecran, 
et sur lequel le programme peut ecrire tous les messages d'erreur qu'il desire. 

Note : La plupart des systemes permettent de rediriger les flux standards des programmes afin 
de les faire travailler sur des donnees provenant d'une autre source de donnees que le clavier, 
ou, par exemple, de leur faire enregistrer leurs resultats dans un fichier. II est meme courant 
de realiser des « pipelines » de programmes, ou les resultats de I'un sont envoyes dans le flux 
d'entree standard de I'autre, et ainsi de suite. Ces suites de programmes sont egalement appeles 
des tubes en frangais. 

La maniere de realiser les redirections des flux standards depend des systemes d'exploitation et 
de leurs interfaces utilisateurs. De plus, les programmes doivent etre capables de travailler avec 
leurs flux d'entree / sortie standards de maniere generique, que ceux-ci soient rediriges ou non. 
Les techniques de redirection ne seront done pas decrites plus en detail ici. 

Vous remarquerez I'interet d'avoir deux flux distincts pour les resultats des programmes et leurs 
messages d'erreur. Si, lors d'une utilisation normale, ces deux flux se melangent a l'ecran, ce 
n'est pas le cas lorsque Ton redirige le flux de sortie standard. Seul le flux d'erreur standard est 
affiche a l'ecran dans ce cas, et les messages d'erreur ne se melangent done pas aux resultats 
du programme. 

On pourrait penser que les programmes graphiques ne disposent pas de flux d'entree / sor- 
tie standards. Pourtant, e'est generalement le cas. Les evenements traites par les programmes 
graphiques dans leur boucle de messages ne proviennent generalement pas du flux d'entree 
standard, mais d'une autre source de donnees specifique a chaque systeme. En consequence, 
les programmes graphiques peuvent toujours utiliser les flux d'entree / sortie standard si cela 
s'avere necessaire. 



Afin de permettre aux programmes d' ecrire sur leurs flux d'entree / sortie standards, la bibliotheque 
C definit plusieurs fonctions extremement utiles. Les deux principales fonctions sont sans doute les 
fonctions printf et scanf. La fonction printf (« print formatted » en anglais) permet d'afficher 
des donnees a l'ecran, et scanf (« scan formatted ») permet de les lire a partir du clavier. 

En realite, ces fonctions ne font rien d' autre que d'appeler deux autres fonctions permettant d' ecrire 
et de lire des donnees sur un fichier : les fonctions f printf et f scanf. Ces fonctions s'utilisent 
exactement de la meme maniere que les fonctions printf et scanf, a ceci pres qu'elles prennent en 
premier parametre une structure decrivant le fichier sur lequel elles travaillent. Pour les flux d'entree / 
sortie standards, la bibliotheque C definit les pseudo-fichiers stdin, stdout et stderr, qui corres- 
pondent respectivement aux flux d'entree, au flux de sortie et au flux d'erreur standards. Ainsi, tout 
appel a scanf se traduit par un appel a f scanf sur le pseudo-fichier stdin, et tout appel a printf 
par un appel a f printf sur le pseudo-fichier stdout. 

Note : II n'existe pas de fonction permettant d'ecrire directement sur le flux d'erreur standard. 
Par consequent, pour effectuer de telles ecritures, il faut imperativement passer par la fonction 
fprintf, en lui fournissant en parametre le pseudo-fichier stderr. 

La description des fonctions de la bibliotheque C standard depasse de loin le cadre de ce cours. 
Aussi les fonctions de lecture et d'ecriture sur les fichiers ne seront-elles pas decrites plus en 
detail ici. Seules les fonctions printf et scant seront presentees, car elles sont reellement in- 
dispensable pour I'ecriture d'un programme C. Consultez la bibliographie si vous desirez obtenir 
plus de details sur la bibliotheque C et sur toutes les fonctions qu'elle contient. 

Le C++ dispose egalement de mecanismes de gestion des flux d'entree / sortie qui lui sont 
propres. Ces mecanismes permettent de controler plus finement les types des donnees ecrites 
et lues de et a partir des flux d'entree / sortie standards. De plus, ils permettent de realiser les 
operations d'ecriture et de lecture des donnees formatees de maniere beaucoup plus simple. 
Cependant, ces mecanismes requierent des notions objets avancees et ne seront decrits que 
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dans les chapitres dedies au C++. Comme il est egalement possible d'utiliser les fonctions printf 
et scanf en C++ d'une part, et que, d'autre part, ces fonctions sont essentielles en C, la suite de 
cette section s'attachera a leur description. Un chapitre complet est dedie aux mecanismes de 
gestion des flux du C++ dans la deuxieme partie de ce document. 



Les fonctions printf et scanf sont toutes deux des fonctions a nombre de parametres variables. 
Elles peuvent done etre utilisees pour effectuer des ecritures et des lectures multiples en un seul appel. 
Afin de leur permettre de determiner la nature des donnees passees dans les arguments variables, elles 
attendent toutes les deux en premier parametre une chaine de caracteres descriptive des arguments 
suivants. Cette chaine est appelee chaine de format, et elle permet de specifier avec precision le type, 
la position et les options de format (precision, etc.) des donnees a traiter. Les deux sections suivantes 
decrivent la maniere d'utiliser ces chaines de format pour chacune des deux fonctions printf et 
scanf. 



1.8.2. La fonction printf 

La fonction printf s'emploie comme suit : 

printf (chaine de format [, valeur [, valeur [...]]]) 



On peut passer autant de valeurs que Ton veut, pour peu qu'elles soient toutes referencees dans la 
chaine de format. Elle renvoie le nombre de caracteres affiches. 

La chaine de format peut contenir du texte, mais surtout elle doit contenir autant de formateurs que 
de variables a afficher. Si ce n'est pas le cas, le programme plantera. Les formateurs sont places dans 
le texte la oil les valeurs des variables doivent etre affichees. 

La syntaxe des formateurs est la suivante : 

% [ [indicateur] . . . ] [largeur] [ .precision] [taille] type 



Un formateur commence done toujours par le caractere %. Pour afficher ce caractere sans faire un 
formateur, il faut le dedoubler (%%). 

Le type de la variable a afficher est obligatoire lui aussi. Les types utilisables sont les suivants : 



Tableau 1-1. Types pour les chaines de format de printf 





Type de donnee a afficher 


Caractere de formatage 


Numeriques 


Entier decimal signe 


d 




Entier decimal non signe 


u ou i 




Entier octal non signe 







Entier hexadecimal non signe 


x (avec les caracteres 'a' a 'f ) ou X 
(avec les caracteres 'A' a 'F') 




Flottants de type double 


f, e, g, E ou G 


Caracteres 


Caractere isole 


c 




Chaine de caracteres 


s 


Pointeurs 


Pointeur 


p 
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Note : Voir le Chapitre 4 pour plus de details sur les pointeurs. Le format des pointeurs depend 
de la machine. 

Les valeurs flottantes infinies sont remplacees par les mentions +inf et -inf. Un non-nombre 
IEEE (Not-A-Number) donne +nan ou -nan. Notez que le standard C ne permet de formater que 
des valeurs de type double. Les valeurs flottantes de type float devront done etre convertie en 
double avant affichage. 



Les autres parametres sont facultatifs. 

Les valeurs disponibles pour le parametre de taille sont les caracteres suivants : 

Tableau 1-2. Options pour les types des chaines de format 



Option 


Type utilisable 


Taille du type 


F 


Pointeur 


Pointeur FAR (DOS uniquement) 


N 


Pointeur 


Pointeur NEAR (DOS uniquement) 


h 


Entier 


short int 


1 


Entier, caractere ou chaine 
de caracteres 


long int ou wchar_t 


L 


Flottant 


long double 



Exemple 1-22. Utilisation de printf et fprintf 

tinclude <stdio.h> /* Ne pas chercher a comprendre cette ligne 

pour 1' instant. Elle est necessaire pour utiliser 
les fonctions printf et scanf . */ 

int main (void) 
{ 

int i = 2; 

print f ( "Voici la valeur de i : %d.\n", i); 

/* Exemple d'ecriture sur la sortie d'erreur standard : */ 

fprintf (stderr, "Pas d'erreur jusqu' ici . . . \n" ) ; 

return ; 
} 

Vous remarquerez dans cet exemple la presence d'une ligne #include <stdio.h>. Cette ligne 
est necessaire pour permettre l'utilisation des fonctions printf et fprintf. Nous decrirons sa si- 
gnification precise ulterieurement dans le chapitre sur le preprocesseur. Sans entrer dans les details, 
disons simplement que cette ligne permet d'inclure un fichier contenant les declarations de toutes les 
fonctions d' entree / sortie de base. 

Les parametres indicateurs, largeur et precision sont moins utilises. II peut y avoir plu- 
sieurs parametres indicateurs, ils permettent de modifier l'apparence de la sortie. Les principales 
options sont : 

• '-' : justification a gauche de la sortie, avec remplissage a droite par des ou des espaces ; 

• '+' : affichage du signe pour les nombres positifs ; 
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espace : les nombres positifs commencent tous par un espace. 



Le parametre largeur permet de specifier la largeur minimale du champ de sortie, si la sortie est 
trop petite, on complete avec des ou des espaces. Notez qu'il s'agit bien d'une largeur minimale ici 
et non d'une largeur maximale. Le resultat du formatage de la donnee a ecrire peut done depasser la 
valeur indiquee pour la largeur du champ. 

Enfin, le parametre precision specifie la precision maximale de la sortie (nombre de chiffres a 
afficher). 



1.8.3. La fonction scanf 

La fonction scanf permet de faire une ou plusieurs entrees. Comme la fonction printf, elle attend 
une chaine de format en premier parametre. II faut ensuite passer les variables devant contenir les 
entrees dans les parametres qui suivent. Sa syntaxe est la suivante : 

scanf (chaine de format, Svariable [, Svariable [-..]]); 



Elle renvoie le nombre de variables lues. 

Ne cherchez pas a comprendre pour 1' instant la signification du symbole & se trouvant devant chacune 
des variables. Sachez seulement que s'il est oublie, le programme plantera. 

La chaine de format peut contenir des chaines de caracteres. Toutefois, si elle contient autre chose que 
des formateurs, le texte saisi par l'utilisateur devra correspondre imperativement avec les chaines de 
caracteres indiquees dans la chaine de format, scanf cherchera a reconnaitre ces chaines, et arretera 
1' analyse a la premiere erreur. 

La syntaxe des formateurs pour scanf differe un peu de celle de ceux de printf : 
%[*] [largeur] [taille]type 



Seul le parametre largeur change par rapport a printf. II permet de specifier le nombre maximal 
de caracteres a prendre en compte lors de l'analyse du parametre. Le parametre '*' est facultatif, il 
indique seulement de passer la donnee entree et de ne pas la stocker dans la variable destination. Cette 
variable doit quand meme etre presente dans la liste des parametres de scanf. 

Note : Tout comme pour les fonctions printf et f printf, il est necessaire d'ajouter la ligne 
♦include <stdio . h> en debut de fichier pour pouvoir utiliser la fonction scant. La signification 
de cette ligne sera donnee dans le chapitre traitant du preprocesseur. 

En pratique, la fonction scant n'analyse les caracteres provenant du flux d'entree que lorsqu'une 
ligne complete a ete saisie. Toutefois, elle ne supprime pas du tampon de flux d'entree le carac- 
tere de saut de ligne, si bien qu'il s'y trouvera toujours lors de I'entree suivante. Cela n'est pas 
genant si Ton n'utilise que la fonction scant pour realiser les entrees de donnees dans le pro- 
gramme, car cette fonction ignore tout simplement ces caracteres de saut de ligne. En revanche, 
si Ton utilise une autre fonction apres un appel a scant, il faut s'attendre a trouver ce caractere 
de saut de ligne dans le flux d'entree. 

La fonction scant n'est pas tres adaptee a la lecture des chaines de caracteres, car il n'est pas 
facile de controler la faille maximale que l'utilisateur peut saisir. C'est pour cette raison que Ton 
a generalement recours a la fonction tgets, qui permet de lire une ligne sur le flux d'entree 
standard et de stocker le resultat dans une chaine de caracteres fournie en premier parametre 
et dont la longueur maximale est specifiee en deuxieme parametre. Le troisieme parametre de 



23 



Chapitre 1. Premiere approche du C/C+ + 



la fonction fgets est le flux a partir duquel la lecture de la ligne doit etre realisee, c'est a dire 
generalement stdin. L'analyse de la chaine de caracteres ainsi lue peut alors etre faite avec une 
fonction similaire a la fonction scant , mais qui lit les caracteres a analyser dans une chaine de 
caracteres au lieu de les lire directement depuis le flux d'entree standard : la fonction sscanf . 
Cette fonction s'utilise exactement comme la fonction scant, a ceci pres qu'il faut lui fournir en 
premier parametre la chaine de caracteres dans laquelle se trouvent les donnees a interpreter. 
La description de ces deux fonctions depasse le cadre de ce document et ne sera done pas faite 
ici. Veuillez vous referer a la documentation de votre environnement de developpement ou a la 
bibliographie pour plus de details a leur sujet. 



1.9. Exemple de programme complet 



Le programme suivant est donne a titre d'exemple. II calcule la moyenne de deux nombres entres au 
clavier et l'affiche : 

Exemple 1-23. Programme complet simple 

#include <stdio.h> /* Autorise l'emploi de printf et de scanf. */ 

long double x, y; 

int main (void) 
{ 

print f ( "Calcul de moyenne\n" ) ; /* Affiche le titre. */ 

print f ( "Entrez le premier nombre : "); 

scanf ("%Lf", &x) ; /* Entre le premier nombre. */ 

print f (" \nEntrez le deuxieme nombre : "); 

scanf ("%Lf", &y) ; /* Entre le deuxieme nombre. */ 

printf ("\nLa valeur moyenne de %Lf et de %Lf est %Lf.\n", 
x, y, (x+y) 12) ; 

return 0; 
} 

Dans cet exemple, les chaines de format specifient des flottants (f) en quadruple precision (L). 
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Nous allons aborder dans ce chapitre un autre aspect du langage indispensable a la programmation, a 
savoir : les structures de controle. Ces structures permettent, comme leur nom l'indique, de controler 
l'execution du programme en fonction de criteres particuliers. Le C et le C++ disposent de toutes 
les structures de controle classiques des langages de programmation comme les tests, les boucles, les 
sauts, etc. Toutes ces structures sont decrites dans les sections suivantes. 



2.1. La structure conditionnelle if 

La structure conditionnelle if permet de realiser un test et d'executer une instruction ou non selon le 
resultat de ce test. Sa syntaxe est la suivante : 

if (test) operation; 

ou test est une expression dont la valeur est booleenne ou entiere. Toute valeur non nulle est consi- 
deree comme vraie. Si le test est vrai, operation est execute. Ce peut etre une instruction ou un bloc 
d' instructions. Une variante permet de specifier Taction a executer en cas de test faux : 

if (test) operation].; 
else operation2; 



Note : Attention ! Les parentheses autour du test sont necessaires 

Les operateurs de comparaison sont les suivants : 
Tableau 2-1. Operateurs de comparaison 



== 


egalite 


!- 


inegalite 


< 


inferiorite 


> 


superiorite 


<= 


inferiorite ou egalite 


>= 


superiorite ou egalite 



Les operateurs logiques applicables aux expressions booleennes sont les suivants 

Tableau 2-2. Operateurs logiques 

&& et logique 

II ou logique 

! negation logique 



II n'y a pas d'operateur ou exclusif logique. 
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Exemple 2-1. Test conditionnel if 

if (a<b && a!=0) 
{ 

m=a; 

nouveau_m=l ; 



2.2. La boucle for 

La structure de controle for est sans doute l'une des plus importantes. Elle permet de realiser toutes 
sortes de boucles et, en particulier, les boucles iterant sur les valeurs d'une variable de controle. Sa 
syntaxe est la suivante : 

for (initialisation ; test ; iteration) operation; 

ou initialisation est une instruction (ou un bloc d' instructions) executee avant le premier par- 
cours de la boucle du for. test est une expression dont la valeur determinera la fin de la boucle. 
iteration est l'operation a effectuer en fin de boucle, et operation constitue le traitement de la 
boucle. Chacune de ces parties est facultative. 

La sequence d' execution est la suivante : 

initialisation 

test : saut en fin du for ou suite 

operation 

iteration 

retour au test 
fin du for. 



Exemple 2-2. Boucle for 

s omme = ; 

for (i=0; i<=10; i=i+l) somme = somme + i; 



Note : En C++, il est possible que la partie initialisation declare une variable. Dans ce cas, 
la variable declaree n'est definie qu'a I'interieur de I'instruction for. Par exemple, 

for (int i = 0; i<10; + + i); 

est strictement equivalent a : 



{ 

int i; 

for (i=0; i<10; ++i) , 



Cela signifie que Ton ne peut pas utiliser la variable i apres instruction for, puisqu'elle n'est 
definie que dans le corps de cette instruction. Cela permet de realiser des variables muettes qui 
ne servent qu'a I'instruction for dans laquelle elles sont definies. 
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Note : Cette regie n'est pas celle utilisee par la plupart des compilateurs C++. La regie qu'ils 
utilisent specifie que la variable declaree dans la partie initialisation de I'instruction for reste 
declaree apres cette instruction. La difference est subtile, mais importante. Cela pose assurement 
des problemes de compatibility avec les programmes C++ ecrits pour ces compilateurs, puisque 
dans un cas la variable doit etre redeclaree et dans I'autre cas elle ne le doit pas. II est done 
recommande de ne pas declarer de variables dans la partie initialisation des instructions 
for pour assurer une portabilite maximale. 



2.3. Le while 



Le while permet d'executer des instructions en boucle tant qu'une condition est vraie. Sa syntaxe est 
la suivante : 

while (test) operation; 

ou operation est effectuee tant que test est verifie. Comme pour le if, les parentheses autour du 
test sont necessaires. L'ordre d'execution est : 

test 
operation 



Exemple 2-3. Boucle while 

s omme = i = ; 
while ( somme<1000 ) 
{ 

s omme = s omme + 2*i/ (5 + i); 

i = i + 1; 
} 



2.4. Le do 



La structure de controle do permet, tout comme le while, de realiser des boucles en attente d'une 
condition. Cependant, contrairement a celui-ci, le do effectue le test sur la condition apres 1' execution 
des instructions. Cela signifie que les instructions sont toujours executees au moins une fois, que le 
test soit verifie ou non. Sa syntaxe est la suivante : 

do operation; 
while (test) ; 

operation est effectuee jusqu'a ce que test ne soit plus verifie. 
L'ordre d'execution est : 

operation 
test 
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Exemple 


2-4. 


. Boucle do 


p = i = 


1; 






do 








{ 








P = 


P 


* i; 




i = 


i 


+ l; 




} while 


(i 


i = 


10); 



2.5. Le branchement conditionnel 

Dans le cas ou plusieurs instructions differentes doivent etre executees selon la valeur d'une variable 
de type integral, l'ecriture de if successifs peut etre relativement lourde. Le C/C++ fournit done la 
structure de controle switch, qui permet de realiser un branchement conditionnel. Sa syntaxe est la 
suivante : 

switch (valeur) 

{ 

case casl : 

[instruction; 

[break; ] 
] 
case cas2 : 

[instruction; 
[break; ] 



case casN: 

[instruction; 

[break; ] 
] 
[default : 

[instruction; 
[break; ] 



valeur est evalue en premier. Son type doit etre entier. Selon le resultat de 1'evaluation, l'execution 
du programme se poursuit au cas de meme valeur. Si aucun des cas ne correspond et si default est 
present, l'execution se poursuit apres default. Si en revanche default n'est pas present, on sort du 

switch. 

Les instructions qui suivent le case approprie ou default sont executees. Puis, les instructions 
du cas suivant sont egalement executees (on ne sort done pas du switch). Pour forcer la sortie du 
switch, on doit utiliser le mot cle break. 
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Exemple 2-5. Branchement conditionnel switch 

i= 2; 

switch (i) 

{ 

case 1 : 

case 2: /* Si i=l ou 2, la ligne suivante sera executee. */ 

i=2-i; 

break; 
case 3 : 

i=0; /* Cette ligne ne sera jamais executee. */ 
default : 

break; 
} 

Note : II est interdit d'effectuer une declaration de variable dans un des case d'un switch. 



2.6. Le saut 



Le C/C++ dispose d'une instruction de saut permettant de poursuivre l'execution du programme en 
un autre point. Bien qu'il soit fortement deconseille de l'utiliser, cette instruction est necessaire et 
peut parfois etre tres utile, notamment dans les traitements d'erreurs. Sa syntaxe est la suivante : 

goto etiquette; 

ou etiquette est une etiquette marquant la ligne destination dans la fonction. Les etiquettes sont 
simplement declarees avec la syntaxe suivante : 

etiquette : 

Les etiquettes peuvent avoir n'importe quel nom d'identificateur. 

II n'est pas possible d'effectuer des sauts en dehors d'une fonction. En revanche, il est possible 
d'effectuer des sauts en dehors et a l'interieur des blocs d' instructions sous certaines conditions. 
Si la destination du saut se trouve apres une declaration, cette declaration ne doit pas comporter 
d'initialisations. De plus, ce doit etre la declaration d'un type simple (c'est-a-dire une declaration qui 
ne demande pas l'execution de code) comme les variables, les structures ou les tableaux. Enfin, si, au 
cours d'un saut, le controle d'execution sort de la portee d'une variable, celle-ci est detruite. 

Note : Ces dernieres regies sont particulierement importantes en C++ si la variable est un objet 
dont la classe a un constructeur ou un destructeur non trivial. Voir le Chapitre 8 pour plus de 
details a ce sujet. 

Autre regie specifique au C++ : il est impossible d'effectuer un saut a l'interieur d'un bloc de code 
en execution protegee try { j . Voir aussi le Chapitre 9 concernant les exceptions. 
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2.7. Les commandes de rupture de sequence 

En plus du goto vu precedemment, il existe d'autres commandes de rupture de sequence (c'est-a-dire 
de changement de la suite des instructions a executer). Ces commandes sont les suivantes : 

continue; 

ou 

break; 

ou 

return [valeur] ; 



return permet de quitter immediatement la fonction en cours. Comme on Fa deja vu, la commande 
return peut prendre en parametre la valeur de retour de la fonction. 

break permet de passer a l'instruction suivant 1'instruction while, do, for ou switch la plus im- 
briquee (c'est-a-dire celle dans laquelle on se trouve). 

continue saute directement a la derniere ligne de l'instruction while, do ou for la plus imbriquee. 
Cette ligne est l'accolade fermante. C'est a ce niveau que les tests de continuation sont faits pour for 
et do, ou que le saut au debut du while est effectue (suivi immediatement du test). On reste done 
dans la structure dans laquelle on se trouvait au moment de l'execution de continue, contrairement 
a ce qui se passe avec le break. 

Exemple 2-6. Rupture de sequence par continue 

/* Calcule la somme des 1000 premiers entiers pairs : */ 

somme_pairs=0 ; 

for (1=0; K1000; i=i+l) 

{ 

if (i % 2 == 1) continue; 

somme_pairs=somme_pairs + i; 
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stockage 

Le langage C/C++ permet la definition de types personnalises construits a partir des types de base 
du langage. Outre les tableaux, que 1'on a deja presentes, il est possible de definir differents types de 
donnees evolues, principalement a l'aide de la notion de structure. Par ailleurs, les variables declarees 
dans un programme se distinguent, outre par leur type, par ce que Ton appelle leur classe de stockage. 
La premiere section de ce chapitre traitera done de la maniere dont on peut creer et manipuler de 
nouveaux types de donnees en C/C++, et la deuxieme section presentera les differentes classes de 
stockage existantes et leur signification precise. 

3.1. Structures de donnees et types complexes 

En dehors des types de variables simples, le C/C++ permet de creer des types plus complexes. Ces 
types comprennent essentiellement les structures, les unions et les enumerations, mais il est egalement 
possible de definir de nouveaux types a partir de ces types complexes. 

3.1.1. Les structures 

Les types complexes peuvent se construire a l'aide de structures. Pour cela, on utilise le mot cle 
struct. Sa syntaxe est la suivante : 

struct [nom_structure] 
{ 

type champ; 

[type champ; 

[...]] 

}; 



II n'est pas necessaire de donner un nom a la structure. La structure contient plusieurs autres variables, 
appelees champs. Leur type est donne dans la declaration de la structure. Ce type peut etre n'importe 
quel autre type, me me une structure. 

La structure ainsi definie peut alors etre utilisee pour definir une variable dont le type est cette struc- 
ture. 

Pour cela, deux possibilites : 

• faire suivre la definition de la structure par l'identificateur de la variable ; 
Exemple 3-1. Declaration de variable de type structure 

struct Client 
{ 

unsigned char Age; 

unsigned char Taille; 
} Jean; 

ou, plus simplement : 



struct 
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unsigned char Age; 
unsigned char Taille; 
} Jean; 



Dans le deuxieme exemple, le nom de la structure n'est pas mis. 

declarer la structure en lui donnant un nom, puis declarer les variables avec la syntaxe suivante : 

[struct] nom_structure identif icateur ; 

Exemple 3-2. Declaration de structure 

struct Client 
{ 

unsigned char Age; 

unsigned char Taille; 

}; 

struct Client Jean, Philippe; 

Client Christophe; // Valide en C++ mais invalide en C 

Dans cet exemple, le nom de la structure doit etre mis, car on utilise cette structure a la ligne 
suivante. Pour la declaration des variables Jean et Philippe de type struct Client, le mot cle 
struct a ete mis. Cela n'est pas necessaire en C++, mais Test en C. Le C++ permet done de 
declarer des variables de type structure exactement comme si le type structure etait un type predefini 
du langage. La declaration de la variable christophe ci-dessus est invalide en C. 



Les elements d'une structure sont accedes par un point, suivi du nom du champ de la structure a 
acceder. Par exemple, l'age de Jean est designe par Jean .Age. 

Note : Le typage du C++ est plus fort que celui du C, parce qu'il considere que deux types ne sont 
identiques que s'ils ont le meme nom. Alors que le C considere que deux types qui ont la meme 
structure sont des types identiques, le C++ les distingue. Cela peut etre un inconvenient, car des 
programmes qui pouvaient etre compiles en C ne le seront pas forcement par un compilateur 
C++. Considerons I'exemple suivant : 

int main (void) 
{ 

struct stl 
{ 

int a; 
} variablel = { 2 } ; 
struct 
{ 

int a; 
} variable2; /* variable2 a exactement la meme structure 

que variablel, */ 
variable2 = variablel; /* mais cela est ILLEGAL en C++ ! */ 
return 0; 
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Bien que les deux variables aient exactement la meme structure, elles sont de type differents ! 
En effet, variabiei est de type « st1 », et variabie2 de type « » (la structure qui a permis de la 
construire n'a pas de nom). On ne peut done pas faire I'affectation. Pourtant, ce programme etait 
compilable en C pur... 



Note : II est possible de ne pas donner de nom a une structure lors de sa definition sans pour 
autant declarer une variable. De telles structures anonymes ne sont utilisables que dans le cadre 
d'une structure incluse dans une autre structure : 



struct struct_principale 
{ 

struct 

{ 

int champl; 

}; 

int champ2; 



Dans ce cas, les champs des structures imbriquees seront accedes comme s'il s'agissait de 
champs de la structure principale. La seule limitation est que, bien entendu, il n'y ait pas de 
conflit entre les noms des champs des structures imbriquees et ceux des champs de la structure 
principale. S'il y a conflit, il faut donner un nom a la structure imbriquee qui pose probleme, en en 
faisant un vrai champ de la structure principale. 



3.1.2. Les unions 

Les unions constituent un autre type de structure. Elles sont declarees avec le mot cle union, qui a 
la meme syntaxe que struct. La difference entre les structures et les unions est que les differents 
champs d'une union occupent le meme espace memoire. On ne peut done, a tout instant, n'utiliser 
qu'un des champs de 1' union. 

Exemple 3-3. Declaration d'une union 

union entier_ou_reel 
{ 

int entier; 

float reel; 
}; 

union entier_ou_reel x; 

x peut prendre 1' aspect soit d'un entier, soit d'un reel. Par exemple : 

x . entier=2; 

affecte la valeur 2 a x . entier, ce qui detruit x . reel. 
Si, a present, on fait : 

x . reel=6 .546; 
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la valeur de x . entier est perdue, car le reel 6 . 54 6 a ete stocke au meme emplacement memoire que 
l'entier x. entier. 

Les unions, contrairement aux structures, sont assez peu utilisees, sauf en programmation systeme ou 
Ton doit pouvoir interpreter des donnees de differentes manieres selon le contexte. Dans ce cas, on 
aura avantage a utiliser des unions de structures anonymes et a acceder aux champs des structures, 
chaque structure permettant de manipuler les donnees selon une de leurs interpretations possibles. 

Exemple 3-4. Union avec discriminant 

struct SystemEvent 
{ 

int iEventType; /* Discriminant de l'evenement. 

Permet de choisir comment 1' interpreter . */ 
union 
{ 

struct 

{ /* Structure permettant d' interpreter */ 

int iMouseX; /* les evenements souris. */ 
int iMouseY; 
}; 

struct 

{ /* Structure permettant d' interpreter */ 

char cCharacter; /* les evenements clavier. */ 
int iShiftState; 
}; 
/* etc. */ 



/* Exemple d' utilisation des evenements : */ 

int ProcessEvent (struct SystemEvent e) 

{ 

int result; 

switch (e . iEventType) 

{ 

case MOUSE_EVENT: 

/* Traitement de l'evenement souris... */ 

result = ProcessMouseEvent (e . iMouseX, e. iMouseY); 

break; 

case KEYBOARD_EVENT : 

/* Traitement de l'evenement clavier... */ 

result = ProcessKbdEvent (e . cCharacter, e . iShiftState) ; 

break; 

} 

return result; 



3.1.3. Les enumerations 

Les enumerations sont des types integraux (c'est-a-dire qu'ils sont bases sur les entiers), pour lesquels 
chaque valeur dispose d'un nom unique. Leur utilisation permet de definir les constantes entieres dans 
un programme et de les nommer. La syntaxe des enumerations est la suivante : 

enum enumeration 
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noml [=valeurl] 
[, nom2 [=valeur2] 
[...]] 



}; 



Dans cette syntaxe, enumeration represente le nom de l'enumeration et noml, nom2, etc. repre- 
sentent les noms des enumeres. Par defaut, les enumeres recoivent les valeurs entieres 0, 1, etc. sauf 
si une valeur explicite leur est donnee dans la declaration de l'enumeration. Des qu'une valeur est don- 
nee, le compteur de valeurs se synchronise avec cette valeur, si bien que l'enumere suivant prendra 
pour valeur celle de l'enumere precedent augmentee de 1. 

Exemple 3-5. Declaration d'une enumeration 

enum Nombre 
{ 

un=l, deux, trois, cinq=5, six, sept 



Dans cet exemple, les enumeres prennent respectivement leurs valeurs. Comme quatre n'est pas 
defini, une resynchronisation a lieu lors de la definition de cinq. 

Les enumerations suivent les memes regies que les structures et les unions en ce qui concerne la 
declaration des variables : on doit repeter le mot cle enum en C, ce n'est pas necessaire en C++. 



3.1.4. Les champs de bits 

II est possible de definir des champs de bits et de donner des noms aux bits de ces champs. Pour cela, 
on utilisera le mot cle struct et on donnera le type des groupes de bits, leurs noms, et enfin leurs 
tailles : 

Exemple 3-6. Declaration d'un champs de bits 

struct champ_de_bits 

{ 

int varl; /* Definit une variable classique. */ 

int bitsla4 : 4; /* Premier champ : 4 bits. */ 

int bits5al0 : 6; /* Deuxieme champ : 6 bits. */ 

unsigned int bitsllal6 : 6; /* Dernier champ : 6 bits. */ 



La taille d'un champ de bits ne doit pas exceder celle d'un entier. Pour aller au-dela, on creera un 
deuxieme champ de bits. La maniere dont les differents groupes de bits sont places en memoire 
depend du compilateur et n'est pas normalised. 

Les differents bits ou groupes de bits seront tous accessibles comme des variables classiques d'une 
structure ou d'une union : 

struct champ_de_bits essai; 

int main (void) 
{ 

essai .bitsla4 = 3; 

/* suite du programme */ 
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return ; 
} 



3.1.5. Initialisation des structures et des tableaux 

Les tableaux et les structures peuvent etre initialisees, tout comme les types classiques peuvent l'etre. 
La valeur servant a 1' initialisation est decrite en mettant les valeurs des membres de la structure ou du 
tableau entre accolades et en les separant par des virgules : 

Exemple 3-7. Initialisation d'une structure 

/* Definit le type Client : */ 

struct Client 

{ 

unsigned char Age; 

unsigned char Taille; 

unsigned int Comptes [ 10 ] ; 



/* Declare et initialise la variable John : */ 

struct Client John={35, 190, {13594, 45796, 0, 0, 0, 0, 0, 0, 0, 0}}; 

La variable John est ici declaree comme etant de type Client et initialisee comme suit : son age est de 
35, sa taille de 190 et ses deux premiers comptes de 13594 et 45796. Les autres comptes sont nuls. 

II n'est pas necessaire de respecter l'imbrication du type complexe au niveau des accolades, ni de 
fournir des valeurs d'initialisations pour les derniers membres d'un type complexe. Les valeurs par 
defaut qui sont utilisees dans ce cas sont les valeurs nulles du type du champ non initialise. Ainsi, la 
declaration de John aurait pu se faire ainsi : 

struct Client John={35, 190, 13594, 45796}; 



Note : La norme C99 fournit egalement une autre syntaxe plus pratique pour initialiser les struc- 
tures. Cette syntaxe permet d'initialiser les differents champs de la structure en les nommant 
explicitement et en leur affectant directement leur valeur. Ainsi, avec cette nouvelle syntaxe, 
I'initialisation precedente peut etre realisee de la maniere suivante : 

Exemple 3-8. Initialisation de structure C99 

/* Declare et initialise la variable John : */ 
struct Client John= { 

.Taille = 190, 

.Age = 35, 

.Comptes[0] = 13594, 

. Comptes [1] = 45796 

>; 

On constatera que les champs qui ne sont pas explicitement initialises sont, encore une fois, 
initialises a leur valeur nulle. De plus, comme le montre cet exemple, il n'est pas necessaire de 
respecter I'ordre d'apparition des differents champs dans la declaration de la structure pour leur 
initialisation. 
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II est possible de melanger les deux syntaxes. Dans ce cas, les valeurs pour lesquelles aucun 
nom de champ n'est donne seront affectees au champs suivants le dernier champ nomme. De 
plus, si plusieurs valeurs differentes sont affectees au meme champ, seule la derniere valeur 
indiquee sera utilisee. 

Cette syntaxe est egalement disponible pour ('initialisation des tableaux. Dans ce cas, on utilis- 
era les crochets directement, sans donner le nom du tableau (exactement comme initialisation 
des membres de la structure utilise directement le point, sans donner le nom de la structure en 
cours d'initialisation). On notera toutefois que cette syntaxe n'est pas disponible en C++. Avec ce 
langage, il est preferable d'utiliser la notion de classe et de definir un constructeur. Les notions 
de classe et de constructeur seront presentees plus en details dans le Chapitre 8. C'est I'un des 
rares points syntaxiques ou il y a incompatibility entre le C et le C++. 



3.1.6. Les alias de types 

Le C/C++ dispose d'un mecanisme de creation d' alias, ou de synonymes, des types complexes. Le 
mot cle a utiliser est typedef . Sa syntaxe est la suivante : 

typedef definition alias; 

ou alias est le nom que doit avoir le synonyme du type et definition est sa definition. Pour les 
tableaux, la syntaxe est particuliere : 

typedef type_tableau type [ (taille) ] ( [taille] (...)); 

type_tableau est alors le type des elements du tableau. 

Exemple 3-9. Definition de type simple 

typedef unsigned int mot; 

mot est strictement equivalent a unsigned int. 

Exemple 3-10. Definition de type tableau 

typedef int tab [10]; 

tab est le synonyme de « tableau de 10 entiers ». 

Exemple 3-11. Definition de type structure 

typedef struct client 
{ 

unsigned int Age; 

unsigned int Taille; 
} Client; 

Client represente la structure client. Attention a ne pas confondre le nom de la structure (« struct 
client ») avec le nom de 1' alias (« Client »). 

Note : Pour comprendre la syntaxe de typedef, il suffit de raisonner de la maniere suivante. Si 
Ton dispose d'une expression qui permet de declarer une variable d'un type donne, alors il suffit 
de placer le mot cle typedef devant cette expression pour faire en sorte que I'identificateur de la 
variable devienne un identificateur de type. Par exemple, si on supprime le mot cle typedef dans 
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la declaration du type Client ci-dessus, alors Client devient une variable dont le type est struct 
client. 



Une fois ces definitions d'alias effectuees, on peut les utiliser comme n'importe quel type, puisqu'ils 
represented des types : 



unsigned int i = 2, j; /* Declare deux unsigned int */ 
tab Tableau; /* Declare un tableau de 10 entiers */ 
Client John; /* Declare une structure client */ 

John. Age = 35; /* Initialise la variable John */ 

John.Taille = 175; 

for (j=0; j<10; j = j+1) Tableau [ j ] = j ; /* Initialise Tableau */ 



3.1 .7. Transtypages 

II est parfois utile de changer le type d'une valeur. Considerons l'exemple suivant : la division de 5 par 
2 renvoie 2. En effet, 5/2 fait appel a la division euclidienne. Comment faire pour obtenir le resultat 
avec un nombre reel ? II faut faire 5 . /2, car alors 5 . est un nombre flottant. Mais que faire quand on 
se trouve avec des variables entieres (i et j par exemple) ? Le compilateur signale une erreur apres i 
dans l'expression i . / j ! II faut changer le type de l'une des deux variables. Cette operation s'appelle 
le transtypage. On la realise simplement en faisant preceder l'expression a transtyper du type desire 
entoure de parentheses : 

(type) expression 



Exemple 3-12. Transtypage en C 

int i=5, j=2; 
((float) i)/j 

Dans cet exemple, i est transtype en flottant avant la division. On obtient done 2.5. 

Le transtypage C est tout puissant et peut etre relativement dangereux. Le langage C++ fournit done 
des operateurs de transtypages plus specifiques, qui permettent par exemple de conserver la Constance 
des variables lors de leur transtypage. Ces operateurs seront decrits dans la Section 10.2 du chapitre 
traitant de 1' identification dynamique des types. 



3.2. Les classes de stockage 



Les variables C/C++ peuvent etre creees de differentes manieres. II est courant, selon la maniere dont 
elles sont creees et la maniere dont elles pourront etre utilisees, de les classer en differentes categories 
de variables. Les differents aspects que peuvent prendre les variables constituent ce que Ton appelle 
leur classe de stockage. 

La classification la plus simple que Ton puisse faire des variables est la classification locale - globale. 
Les variables globales sont declarees en dehors de tout bloc d'instructions, dans la zone de decla- 
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ration globale du programme. Les variables locales en revanche sont creees a l'interieur d'un bloc 
d' instructions. Les variables locales et globales ont des durees de vie, des portees et des emplace- 
ments en memoire differents. 

La portee d'une variable est la zone du programme dans laquelle elle est accessible. La portee 
des variables globales est tout le programme, alors que la portee des variables locales est le bloc 
d' instructions dans lequel elles ont ete creees. 

La duree de vie d'une variable est le temps pendant lequel elle existe. Les variables globales sont 
creees au debut du programme et detruites a la fin, leur duree de vie est done celle du programme. En 
general, les variables locales ont une duree de vie qui va du moment oil elles sont declarees jusqu'a 
la sortie du bloc d' instructions dans lequel elles ont ete declarees. Cependant, il est possible de faire 
en sorte que les variables locales survivent a la sortie de ce bloc d'instructions. D' autre part, la portee 
d'une variable peut commencer avant sa duree de vie si cette variable est declaree apres le debut du 
bloc d'instructions dans lequel elle est declaree. La duree de vie n'est done pas egale a la portee d'une 
variable. 

La classe de stockage d'une variable permet de specifier sa duree de vie et sa place en memoire (sa 
portee est toujours le bloc dans lequel la variable est declaree). Le C/C++ dispose d'un eventail de 
classes de stockage assez large et permet de specifier le type de variable que Ton desire utiliser : 

• auto : la classe de stockage par defaut. Les variables ont pour portee le bloc d'instructions dans 
lequel elles ont ete crees. Elles ne sont accessibles que dans ce bloc. Leur duree de vie est restreinte 
a ce bloc. Ce mot cle est facultatif, la classe de stockage auto etant la classe par defaut ; 

static : cette classe de stockage permet de creer des variables dont la portee est le bloc 
d'instructions en cours, mais qui, contrairement aux variables auto, ne sont pas detruites lors 
de la sortie de ce bloc. A chaque fois que Ton rentre dans ce bloc d'instructions, les variables 
statiques existeront et auront pour valeurs celles qu'elles avaient avant que Ton quitte ce bloc. 
Leur duree de vie est done celle du programme, et elles conservent leurs valeurs. Un fichier peut 
etre considere comme un bloc. Ainsi, une variable statique d'un fichier ne peut pas etre accedee a 
partir d'un autre fichier. Cela est utile en compilation separee (voir plus loin) ; 

register : cette classe de stockage permet de creer une variable dont l'emplacement se trouve 
dans un registre du microprocesseur. II faut bien connaitre le langage machine pour correctement 
utiliser cette classe de variable. En pratique, cette classe est tres peu utilisee ; 

• volatile : cette classe de variable sert lors de la programmation systeme. Elle indique qu'une 
variable peut etre modifiee en arriere-plan par un autre programme (par exemple par une interrup- 
tion, par un thread, par un autre processus, par le systeme d' exploitation ou par un autre processeur 
dans une machine parallele). Cela necessite done de recharger cette variable a chaque fois qu'on 
y fait reference dans un registre du processeur, et ce meme si elle se trouve dejd dans un de ces 
registres (ce qui peut arriver si on a demande au compilateur d'optimiser le programme) ; 

• extern: cette classe est utilisee pour signaler que la variable peut etre definie dans un autre fichier. 
Elle est utilisee dans le cadre de la compilation separee (voir le Chapitre 6 pour plus de details). 



II existe egalement des modificateurs pouvant s'appliquer a une variable pour preciser sa Constance : 

• const : ce mot cle est utilise pour rendre le contenu d'une variable non modifiable. En quelque 
sorte, la variable devient ainsi une variable en lecture seule. Attention, une telle variable n'est pas 
forcement une constante : elle peut etre modifiee soit par 1' intermediate d'un autre identificateur, 
soit par une entite exterieure au programme (comme pour les variables volatile). Quand ce mot 
cle est applique a une structure, aucun des champs de la structure n'est accessible en ecriture. Bien 
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qu'il puisse paraitre etrange de vouloir rendre « constante » une « variable », ce mot cle a une 
utilite. En particulier, il permet de faire du code plus sur ; 

• mutable : disponible uniquement en C++, ce mot cle ne sert que pour les membres des structures. 
II permet de passer outre la Constance eventuelle d'une structure pour ce membre. Ainsi, un champ 
de structure declare mutable peut etre modifie meme si la structure est declaree const. 



Pour declarer une classe de stockage particuliere, il suffit de faire preceder ou suivre le type de la 
variable par l'un des mots cles auto, static, register, etc. On n'a le droit de n'utiliser que les 
classes de stockage non contradictoires. Par exemple, register et extern sont incompatibles, de 

meme que register et volatile, et const et mutable. Par contre, static et const, de meme 
que const et volatile, peuvent etre utilisees simultanement. 

Exemple 3-13. Declaration d'une variable locale statique 

int appels (void) 
{ 

static int n = 0; 

return n = n+1; 



Cette fonction memorise le nombre d' appels qui lui ont ete faits dans la variable n et renvoie ce 
nombre. En revanche, la fonction suivante : 



int appels (void) 
{ 

int n = 0; 

return n =n + 1 ; 
} 

renverra toujours 1. En effet, la variable n est creee, initialisee, incrementee et detruite a chaque appel. 
Elle ne survit pas a la fin de l'instruction return. 

Exemple 3-14. Declaration d'une variable constante 

const int i=3; 

i prend la valeur 3 et ne peut plus etre modifiee. 

Les variables globales qui sont definies sans le mot cle const sont traitees par le compilateur comme 
des variables de classe de stockage extern par defaut. Ces variables sont done accessibles a partir de 
tous les fichiers du programme. En revanche, cette regie n'est pas valide pour les variables definies 
avec le mot cle const. Ces variables sont automatiquement declarees static par le compilateur, ce 
qui signifie qu'elles ne sont accessibles que dans le fichier dans lequel elles ont ete declarees. Pour 
les rendre accessibles aux autres fichiers, il faut imperativement les declarer avec le mot cle extern 
avant de les definir. 

Exemple 3-15. Declaration de constante externes 

i est accessible de tous les fichiers. */ 
Synonyme de "static const int j = 11;". */ 

Declare d' abord la variable k... */ 
puis donne la definition. */ 
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int i = 12; 




/ 


const int j = 11; 




/ 


extern const int 


k; 


/ 


const int k = 12; 




/ 
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Notez que toutes les variables definies avec le mot cle const doivent etre initialisees lors de leur 
definition. En effet, on ne peut pas modifier la valeur des variables const, elles doivent done avoir 
une valeur initiale. Enfin, les variables statiques non initialisees prennent la valeur nulle. 

Les mots cles const et volatile demandent au compilateur de realiser des verifications addition- 
nelles lors de l'emploi des variables qui ont ces classes de stockage. En effet, le C/C++ assure qu'il 
est interdit de modifier (du moins sans magouiller) une variable de classe de stockage const, et il 
assure egalement que toutes les references a une variable de classe de stockage volatile se feront 
sans optimisations dangereuses. Ces verifications sont basees sur le type des variables manipulees. 
Dans le cas des types de base, ces verifications sont simples et de comprehension immediate. Ainsi, 
les lignes de code suivantes : 

const int i=3; 
int j = 2; 

i=j; /* Illegal : i est de type const int. */ 

generent une erreur parce qu'on ne peut pas affecter une valeur de type int a une variable de type 
const int. 

En revanche, pour les types complexes (pointeurs et references en particulier), les mecanismes de 
verifications sont plus fins. Nous verrons quels sont les problemes souleves par l'emploi des mots 
cles const et volatile avec les pointeurs et les references dans le chapitre traitant des pointeurs. 

Enfin, en C++ uniquement, le mot cle mutable permet de rendre un champ de structure const 
accessible en ecriture : 

Exemple 3-16. Utilisation du mot cle mutable 

struct A 
{ 

int i; // Non modifiable si A est const. 

mutable int j ; // Toujours modifiable. 

}; 

const A a={l, 1}; // i et j valent 1. 

int main (void) 
{ 

a.i=2; // ERREUR ! a est de type const A ! 

a.j=2; // Correct : j est mutable. 

return 0; 
} 
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Les pointeurs sont des variables tres utilisees en C et en C++. lis doivent etre considered comme 
des variables, il n'y a rien de sorcier derriere les pointeurs. Cependant, les pointeurs ont un domaine 
d' application tres vaste. 

Les references sont des identificateurs synonymes d'autres identificateurs, qui permettent de manipu- 
ler certaines notions introduites avec les pointeurs plus souplement. Elles n'existent qu'en C++. 



4.1. Notion d'adresse 

Tout objet manipule par l'ordinateur est stocke dans sa memoire. On peut considerer que cette me- 
moire est constitute d'une serie de « cases », cases dans lesquelles sont stockees les valeurs des 
variables ou les instructions du programme. Pour pouvoir acceder a un objet (la valeur d'une variable 
ou les instructions a executer par exemple), c'est-a-dire au contenu de la case memoire dans laquelle 
cet objet est enregistre, il faut connaitre le numero de cette case. Autrement dit, il faut connaitre 
l'emplacement en memoire de l'objet a manipuler. Cet emplacement est appele Yadresse de la case 
memoire, et par extension, Yadresse de la variable ou Yadresse de lafonction stockee dans cette case 
et celles qui la suivent. 

Toute case memoire a une adresse unique. Lorsqu'on utilise une variable ou une fonction, le com- 
pilateur manipule l'adresse de cette derniere pour y acceder. C'est lui qui connait cette adresse, le 
programmeur n'a pas a s'en soucier. 



4.2. Notion de pointeur 



Une adresse est une valeur. On peut done stacker cette valeur dans une variable. Les pointeurs sont 
justement des variables qui contiennent l'adresse d'autres objets, par exemple l'adresse d'une autre 
variable. On dit que le pointeur pointe sur la variable pointee. Ici, pointer signifie « faire reference a ». 
Les adresses sont generalement des valeurs constantes, car en general un objet ne se deplace pas en 
memoire. Toutefois, la valeur d'un pointeur peut changer. Cela ne signifie pas que la variable pointee 
est deplacee en memoire, mais plutot que le pointeur pointe sur autre chose. 

Afin de savoir ce qui est pointe par un pointeur, les pointeurs disposent d'un type. Ce type est construit 
a partir du type de l'objet pointe. Cela permet au compilateur de verifier que les manipulations reali- 
sees en memoire par 1' intermediate du pointeur sont valides. Le type des pointeur se lit « pointeur de 
... », ou les points de suspension represented le nom du type de l'objet pointe. 

Les pointeurs se declarent en donnant le type de l'objet qu'ils devront pointer, suivi de leur identifi- 
cateur precede d'une etoile : 

int *pi; // pi est un pointeur d'entier. 



Note : Si plusieurs pointeurs doivent etre declares, I'etoile doit etre repetee 

int *pil, *pi2, j, *pi3; 

Ici, pii, pi2 et pi3 sont des pointeurs d'entiers et j est un entier. 
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Figure 4-1. Notion de pointeur et d'adresse 

Adr esses Memoir e Variables 





Adr 


:sses croissantes 
A , 




23444 


45 




23443 


461 


■*-, 


23442 




23441 




23440 


23443 


23433 














2 






1 














pil 



II est possible de faire un pointeur sur une structure dans une structure en indiquant le nom de la 
structure comme type du pointeur : 

typedef struct nom 
{ 

struct nom *pointeur; /* Pointeur sur une structure "nom". */ 

} MaStructure; 



Ce type de construction permet de creer des listes de structures, dans lesquelles chaque structure 
contient l'adresse de la structure suivante dans la liste. Nous verrons plus loin un exemple d'utilisation 
de ce genre de structure. 

II est egalement possible de creer des pointeurs sur des fonctions, et d'utiliser ces pointeurs pour para- 
meter un algorithme, dont le comportement dependra des fonctions ainsi pointees. Nous detaillerons 
plus loin ce type d'utilisation des pointeurs. 



4.3. Dereferencement, indirection 

Un pointeur ne servirait strictement a rien s'il n'y avait pas de possibilite d'acceder a l'adresse d'une 
variable ou d'une fonction (on ne pourrait alors pas 1' initialiser) ou s'il n'y avait pas moyen d'acceder 
a 1'objet reference par le pointeur (la variable pointee ne pourrait pas etre manipulee ou la fonction 
pointee ne pourrait pas etre appelee). 

Ces deux operations sont respectivement appelees indirection et dereferencement. II existe deux ope- 
rateurs permettant de recuperer l'adresse d'un objet et d'acceder a 1'objet pointe. Ces operateurs sont 
respectivement & et *. 

II est tres important de s'assurer que les pointeurs que Ton manipule sont tous initialises (c'est-a- 
dire contiennent l'adresse d'un objet valide, et pas n'importe quoi). En effet, acceder a un pointeur 
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non initialise revient a lire ou, plus grave encore, a ecrire dans la memoire a un endroit completement 
aleatoire (selon la valeur initiale du pointeur lors de sa creation). En general, on initialise les pointeurs 
des leur creation, ou, s'ils doivent etre utilises ulterieurement, on les initialise avec le pointeur nul. 
Cela permettra de faire ulterieurement des tests sur la validite du pointeur ou au moins de detecter 
les erreurs. En effet, l'utilisation d'un pointeur initialise avec le pointeur nul genere souvent une faute 
de protection du programme, que tout bon debogueur est capable de detecter. Le pointeur nul se note 

NULL. 

Note : null est une macro definie dans le fichier d'en-tete stdiib.h. En C, elle represents la 
valeur d'une adresse invalide. Malheureusement, cette valeur peut ne pas etre egale a I'adresse 
o (certains compilateurs utilisent la valeur -1 pour null par exemple). C'est pour cela que cette 
macro a ete definie, afin de representee selon le compilateur, la bonne valeur. Voir le Chapitre 5 
pour plus de details sur les macros et sur les fichiers d'en-tete. 

La norme du C++ fixe la valeur nulle des pointeurs a o. Par consequent, les compilateurs C/C++ 
qui definissent null comme etant egal a -l posent un probleme de portability certain, puisque un 
programme C qui utilise null n'est plus valide en C++. Par ailleurs, un morceau de programme 
C++ compilable en C qui utiliserait la valeur o ne serait pas correct en C. 

II faut done faire un choix : soit utiliser null en C et o en C++, soit utiliser null partout, quitte a 
redefinir la macro null pour les programmes C++ (solution qui me semble plus pratique). 



Exemple 4-1. Declaration de pointeurs 

int i=0; /* Declare une variable entiere. */ 

int *pi; /* Declare un pointeur sur un entier. */ 

pi=&i; /* Initialise le pointeur avec I'adresse de cette 

variable. */ 
*pi = *pi+l; /* Effectue un calcul sur la variable pointee par pi, 
e'est-a-dire sur i lui-meme, puisque pi contient 
I'adresse de i. */ 

/* A ce stade, i ne vaut plus 0, mais 1. */ 

II est a present facile de comprendre pourquoi il faut repeter l'etoile dans la declaration de plusieurs 
pointeurs : 

int *pl, *p2, *p3; 

signifie syntaxiquement : pi, p2 et p3 sont des pointeurs d'entiers, mais aussi *pl, *p2 et *p3 sont 
des entiers. 

Si Ton avait ecrit : 

int *pl, p2, p3; 

seul pi serait un pointeur d'entier. p2 et p3 seraient des entiers. 

L'acces aux champs d'une structure par le pointeur sur cette structure se fera avec l'operateur '->', 
qui remplace ' ( * ) 

Exemple 4-2. Utilisation de pointeurs de structures 

struct Client 
{ 

int Age; 
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}; 

Client structure].; 

Client *pstr = Sstructurel ; 

pstr->Age = 35; /* On aurait pu ecrire (*pstr) .Age=35; */ 



4.4. Notion de reference 

En plus des pointeurs, le C++ permet de creer des references. Les references sont des synonymes 
d'identificateurs. Elles permettent de manipuler une variable sous un autre nom que celui sous laquelle 
cette derniere a ete declaree. 

Note : Les references n'existent qu'en C++. Le C ne permet pas de creer des references. 



Par exemple, si « id » est le nom d'une variable, il est possible de creer une reference « ref » de 
cette variable. Les deux identificateurs id et ref represented alors la meme variable, et celle-ci peut 
etre accedee et modifiee a l'aide de ces deux identificateurs indistinctement. 

Toute reference doit se referer a un identificateur : il est done impossible de declarer une reference 
sans 1' initialiser. De plus, la declaration d'une reference ne cree pas un nouvel objet comme e'est 
le cas pour la declaration d'une variable par exemple. En effet, les references se rapportent a des 
identificateurs deja existants. 

La syntaxe de la declaration d'une reference est la suivante : 

type Sreference = identificateur; 



Apres cette declaration, reference peut etre utilise partout oil identificateur peut l'etre. Ce sont des 
synonymes. 

Exemple 4-3. Declaration de references 

int i=0; 

int &ri=i; // Reference sur la variable i. 

ri=ri+i; // Double la valeur de i (et de ri) . 

II est possible de faire des references sur des valeurs numeriques. Dans ce cas, les references doivent 
etre declarees comme etant constantes, puisqu'une valeur est une constante : 

const int &ri=3; // Reference sur 3. 

int &error=4; // Erreur ! La reference n' est pas constante. 



4.5. Lien entre les pointeurs et les references 



Les references et les pointeurs sont etroitement lies. En effet, une variable et ses differentes references 
ont la meme adresse, puisqu'elles permettent d'acceder a un meme objet. Utiliser une reference pour 
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manipuler un objet revient done exactement au meme que de manipuler un pointeur constant conte- 
nant l'adresse de cet objet. Les references permettent simplement d'obtenir le meme resultat que les 
pointeurs, mais avec une plus grande facilite d'ecriture. 

Cette similitude entre les pointeurs et les references se retrouve au niveau syntaxique. Par exemple, 
considerons le morceau de code suivant : 

int i=0; 

int *pi=&i; 

*pi=*pi+l; // Manipulation de i via pi. 

et faisons passer l'operateur & de la deuxieme ligne a gauche de l'operateur d'affectation : 



int i=0; 

int S*pi=i; // Cela genere une erreur de syntaxe mais nous 

// l'ignorons pour les besoins de 1' explication . 
*pi=*pi+l; 



Maintenant, comparons avec le morceau de code equivalent suivant : 

int i=0; 

int &ri=i; 

ri=ri+l; // Manipulation de i via ri . 



Nous constatons que la reference ri peut etre identifiee avec l'expression *pi, qui represente bel et 
bien la variable i. Ainsi, la reference ri encapsule la manipulation de l'adresse de la variable i et 
s'utilise comme l'expression *pi. Cela permet de comprendre l'origine de la syntaxe de declaration 
des references. La difference se trouve ici dans le fait que les references doivent etre initialisees d'une 
part, et que Ton n'a pas a effectuer le dereferencement d'autre part. Les references sont done beaucoup 
plus faciles a manipuler que les pointeurs, et permettent de faire du code beaucoup plus sur. 



4.6. Passage de parametres par variable ou par valeur 

II y a deux methodes pour passer des variables en parametre dans une fonction : le passage par valeur 
et le passage par variable. Ces methodes sont decrites ci-dessous. 

4.6.1. Passage par valeur 

La valeur de l'expression passee en parametre est copiee dans une variable locale. C'est cette variable 
qui est utilisee pour faire les calculs dans la fonction appelee. 

Si l'expression passee en parametre est une variable, son contenu est copie dans la variable locale. 
Aucune modification de la variable locale dans la fonction appelee ne modifie la variable passee en 
parametre, parce que ces modifications ne s'appliquent qu'a une copie de cette derniere. 

Le C ne permet de faire que des passages par valeur. 
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Exemple 4-4. Passage de parametre par valeur 

void test (int j) /* j est la copie de la valeur passee en 

parametre */ 
{ 

j = 3; /* Modifie j, mais pas la variable fournie 

par 1' appelant. */ 
return; 
} 

int main (void) 
{ 

int i=2; 

test(i); /* Le contenu de i est copie dans j. 

i n'est pas modifie. II vaut toujours 2. */ 

test (2); /* La valeur 2 est copiee dans j. */ 

return 0; 



4.6.2. Passage par variable 

La deuxieme technique consiste a passer non plus la valeur des variables comme parametre, mais a 
passer les variables elles-memes. II n'y a done plus de copie, plus de variable locale. Toute modifica- 
tion du parametre dans la fonction appelee entraine la modification de la variable passee en parametre. 

Le C ne permet pas de faire ce type de passage de parametres (le C++ le permet en revanche). 

Exemple 4-5. Passage de parametre par variable en Pascal 

Var i : integer; 

Procedure test (Var j : integer) 
Begin 

{La variable j est strictement egale 
a la variable passee en parametre.} 
j:=2; {Ici, cette variable est modifiee.} 
End; 

Begin 

i:=3; {Initialise i a 3} 

test(i); {Appelle la fonction. La variable i est passee en 
parametres, pas sa valeur. Elle est modifiee par 
la fonction test.} 

{ Ici, i vaut 2 . } 
End. 

Puisque la fonction attend une variable en parametre, on ne peut plus appeler test avec une valeur 
(test ( 3 ) est maintenant interdit, car 3 n'est pas une variable : on ne peut pas le modifier). 
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4.6.3. Avantages et inconvenients des deux methodes 

Les passages par variables sont plus rapides et plus economes en memoire que les passages par valeur, 
puisque les etapes de la creation de la variable locale et la copie de la valeur ne sont pas faites. II 
faut done eviter les passages par valeur dans les cas d'appels recursifs de fonction ou de fonctions 
travaillant avec des grandes structures de donnees (matrices par exemple). 

Les passages par valeurs permettent d' eviter de detruire par megarde les variables passees en para- 
metre. Si Ton veut se prevenir de la destruction accidentelle des parametres passes par variable, il 
faut utiliser le mot cle const. Le compilateur interdira alors toute modification de la variable dans la 
fonction appelee, ce qui peut parfois obliger cette fonction a realiser des copies de travail en local. 

4.6.4. Comment passer les parametres par variable en C ? 

II n'y a qu'une solution : passer l'adresse de la variable. Cela constitue done une application des 
pointeurs. 

Voici comment 1' Exemple 4-5 serait programme en C : 

Exemple 4-6. Passage de parametre par variable en C 

void test (int *pj) /* test attend l'adresse d'un entier... */ 
{ 

*pj=2; /* ... pour le modifier. */ 

return; 
} 

int main (void) 
{ 

int i=3; 

test(Si); /* On passe l'adresse de i en parametre. */ 

/* Ici, i vaut 2. */ 

return 0; 
} 

A present, il est facile de comprendre la signification de & dans l'appel de scant : les variables a 
entrer sont passees par variable. 



4.6.5. Passage de parametres par reference 

La solution du C est exactement la meme que celle du Pascal du point de vue semantique. En fait, 
le Pascal procede exactement de la meme maniere en interne, mais la manipulation des pointeurs est 
masquee par le langage. Cependant, plusieurs problemes se posent au niveau syntaxique : 

• la syntaxe est lourde dans la fonction, a cause de l'emploi de l'operateur * devant les parametres ; 

• la syntaxe est dangereuse lors de l'appel de la fonction, puisqu'il faut systematiquement penser a 
utiliser l'operateur & devant les parametres. Un oubli devant une variable de type entier et la valeur 
de l'entier est utilisee a la place de son adresse dans la fonction appelee (plantage assure, essayez 
avec scant). 
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Le C++ permet de resoudre tous ces problemes a 1'aide des references. Au lieu de passer les adresses 
des variables, il suffit de passer les variables elles-memes en utilisant des parametres sous la forme de 
references. La syntaxe des parametres devient alors : 

type sidentif icateur [, type sidentif icateur [...]] 



Exemple 4-7. Passage de parametre par reference en C++ 

void test (int &i) // i est une reference du parametre constant. 
{ 

i = 2; // Modifie le parametre passe en reference. 

return; 



int main (void) 
{ 

int i=3; 

test (i) ; 

// Apres l'appel de test, i vaut 2. 

// L'operateur & n' est pas necessaire pour appeler 

// test. 

return 0; 
} 

II est recommande, pour des raisons de performances, de passer par reference tous les parametres dont 
la copie peut prendre beaucoup de temps (en pratique, seuls les types de base du langage pourront etre 
passes par valeur). Bien entendu, il faut utiliser des references constantes au maximum afin d'eviter 
les modifications accidentelles des variables de la fonction appelante dans la fonction appelee. En 
revanche, les parametres de retour des fonctions ne devront pas etre declares comme des references 
constantes, car on ne pourrait pas les ecrire si c'etait le cas. 

Exemple 4-8. Passage de parametres constant par reference 

typedef struct 
{ 

} structure; 

void ma_fonction (const structure & s) 
{ 

return ; 
} 

Dans cet exemple, s est une reference sur une structure constante. Le code se trouvant a l'interieur 
de la fonction ne peut done pas utiliser la reference s pour modifier la structure (on notera cependant 
que e'est la fonction elle-meme qui s'interdit l'ecriture dans la variable s. const est done un mot 
cle « cooperatif ». II n'est pas possible a un programmeur d'empecher ses collegues d'ecrire dans ses 
variables avec le mot cle const. Nous verrons dans le Chapitre 8 que le C++ permet de pallier ce 
probleme grace a une technique appelee l'encapsulation.). 

Un autre avantage des references constantes pour les passages par variables est que si le parametre 
n'est pas une variable ou, s'il n'est pas du bon type, une variable locale du type du parametre est creee 
et initialisee avec la valeur du parametre transtype. 
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Exemple 4-9. Creation d'un objet temporaire lors d'un passage par reference 

void test (const int Si) 
{ 

... // Utilisation de la variable i 

// dans la fonction test. La variable 
// i est creee si necessaire. 
return ; 
} 

int main (void) 
{ 

test (3); // Appel de test avec une constante. 

return ; 
} 

Au cours de cet appel, une variable locale est creee (la variable i de la fonction test), et 3 lui est 
affectee. 



4.7. References et pointeurs constants et volatiles 

L'utilisation des mots cles const et volatile avec les pointeurs et les references est un peu plus 
compliquee qu'avec les types simples. En effet, il est possible de declarer des pointeurs sur des va- 
riables, des pointeurs constants sur des variables, des pointeurs sur des variables constantes et des 
pointeurs constants sur des variables constantes (bien entendu, il en est de meme avec les references). 
La position des mots cles const et volatile dans les declarations des types complexes est done 
extremement importante. En general, les mots cles const et volatile caracterisent ce qui les pre- 
cede dans la declaration, si Ton adopte comme regie de toujours les placer apres les types de base. 
Par exemple, 1' expression suivante : 

const int *pi; 

peut etre reecrite de la maniere suivante : 



int const *pi; 

puisque le mot cle const est interchangeable avec le type le plus simple dans une declaration. Ce 
mot cle caracterise done le type int, et pi est un pointeur sur un entier constant. En revanche, dans 
1' exemple suivant : 



int j; 

int * const pi=&j; 

pi est declare comme etant constant, et de type pointeur d'entier. II s'agit done d'un pointeur constant 
sur un entier non constant, que Ton initialise pour referencer la variable j. 

Note : Les declarations C++ peuvent devenir tres compliquees et difficiles a lire. II existe une 
astuce qui permet de les interpreter facilement. Lors de I'analyse de la declaration d'un identifica- 
teur x, il faut toujours commencer par une phrase du type « x est un . . . ». Pour trouver la suite 
de la phrase, il suffit de lire la declaration en partant de I'identificateur et de suivre I'ordre impose 
par les priorites des operateurs. Cet ordre peut etre modifie par la presence de parentheses. 
L'annexe B donne les priorites de tous les operateurs du C++. 
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Ainsi, dans I'exemple suivant : 

const int *pi[12]; 

void (*pf) (int * const pi); 

la premiere declaration se lit de la maniere suivante : « pi (pi) est un tableau (n) de 12 (12) 
pointeurs (*) d'entiers (int) constants (const) ». La deuxieme declaration se lit : « pf (pf) est un 
pointeur (*) de fonction (0) de pi (pi), qui est lui-meme une constante (const) de type pointeur 
(*) d'entier (int). Cette fonction ne renvoie rien (void) ». 



Le C et le C++ n'autorisent que les ecritures qui conservent ou augmentent les proprietes de Constance 
et de volatilite. Par exemple, le code suivant est correct : 

char *pc; 

const char *cpc; 

cpc=pc; /* Le passage de pc a cpc augmente la Constance. */ 

parce qu'elle signifie que si Ton peut ecrire dans une variable par l'intermediaire du pointeur pc, 
on peut s'interdire de le faire en utilisant cpc a la place de pc. En revanche, si Ton n'a pas le droit 
d' ecrire dans une variable, on ne peut en aucun cas se le donner. 

Cependant, les regies du langage relatives a la modification des variables peuvent parfois paraitre 
etranges. Par exemple, le langage interdit une ecriture telle que celle-ci : 

char *pc; 

const char **ppc; 

ppc = &pc; /* Interdit ! */ 



Pourtant, cet exemple ressemble beaucoup a I'exemple precedent. On pourrait penser que le fait 
d'affecter un pointeur de pointeur de variable a un pointeur de pointeur de variable constante revient 
a s'interdire d'ecrire dans une variable qu'on a le droit de modifier. Mais en realite, cette ecriture 
va contre les regies de Constances, parce qu'elle permettrait de modifier une variable constante. Pour 
s'en convaincre, il faut regarder I'exemple suivant : 

La variable constante. */ 

Pointeur par l'intermediaire duquel 

nous allons modifier c. */ 

Interdit, mais supposons que ce ne le 

soit pas . */ 

Parfaitement legal. */ 

Modifie la variable c. */ 



Que s'est-il passe ? Nous avons, par l'intermediaire de ppc, affecte l'adresse de la constante c au poin- 
teur pc. Malheureusement, pc n'est pas un pointeur de constante, et cela nous a permis de modifier 
la constante c. 

Afin de gerer correctement cette situation (et les situations plus complexes qui utilisent des triples 
pointeurs ou encore plus d'indirection), le C et le C++ interdisent l'affectation de tout pointeur dont 



const char 


c=' a' ; 




/ 


char *pc; 






/ 


const char 


**ppc= 


= &pc; 


/ 


*ppc=&c; 






/ 


*pc='b' ; 






/ 
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les proprietes de Constance et de volatilite sont moindres que celles du pointeur cible. La regie exacte 
est la suivante : 

1. On note cv les differentes qualifications de Constance et de volatilite possibles (a savoir : const 

volatile, const, volatile ou aucune classe de stockage). 

2. Si le pointeur source est un pointeur cvs , de pointeur cvs , 1 de pointeur ... de pointeur cvs , n- 
1 de type Ts cvs, n, et que le pointeur destination est un pointeur cvd, de pointeur cvd, 1 
de pointeur ... de pointeur cvd, n-1 de type Td cvs,n, alors l'affectation de la source a la 
destination n'est legale que si : 

• les types source Ts et destination Td sont compatibles ; 

• il existe un nombre entier strictement positif N tel que, quel que soit j superieur ou egal a N, 
on ait : 

• si const apparait dans cvs, j, alors const apparait dans cvd, j ; 

• si volatile apparait dans cvs, j, alors volatile apparait dans cvd, j ; 

• et tel que, quel que soit 0<k<N, const apparaisse dans cvd, k. 



Ces regies sont suffisamment compliquees pour ne pas etre apprises. Les compilateurs se chargeront 
de signaler les erreurs s'il y en a en pratique. Par exemple : 

const char c='a'; 

const char *pc; 

const char **ppc=&pc; /* Legal a present. */ 

*ppc=&c; 

*pc='b'; /* Illegal (pc a change de type) . */ 



L'affectation de double pointeur est a present legale, parce que le pointeur source a change de type 
(on ne peut cependant toujours pas modifier le caractere c). 

II existe une exception notable a ces regies : l'initialisation des chaines de caracteres. Les chaines de 
caracteres telles que : 

"Bon jour tout le monde ! " 

sont des chaines de caracteres constantes. Par consequent, on ne peut theoriquement affecter leur 
adresse qu'a des pointeurs de caracteres constants : 

const char *pc="Coucou !"; /* Code correct. */ 



Cependant, il a toujours ete d'usage de realiser l'initialisation des chaines de caracteres de la maniere 
suivante : 

char *pc="Coucou ! " ; /* Theoriquement illegal, mais tolere 

par compatibility avec le C. */ 
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Par compatibility, le langage fournit done une conversion implicite entre « const char * » et 
« char * ». Cette facilite ne doit pas pour autant vous inciter a transgresser les regies de Constance : 
utilisez les pointeurs sur les chaines de caracteres constants autant que vous le pourrez (quitte a rea- 
liser quelques copies de chaines lorsqu'un pointeur de caractere simple doit etre utilise). Sur certains 
systemes, l'ecriture dans une chaine de caracteres constante peut provoquer un plantage immediat du 
programme. 



4.8. Arithmetique des pointeurs 

II est possible d'effectuer des operations arithmetiques sur les pointeurs. 

Les seules operations valides sont les operations externes (addition et soustraction des entiers) et la 
soustraction de pointeurs. Elles sont definies comme suit (la soustraction d'un entier est consideree 
comme l'addition d'un entier negatif) : 

p + i = adresse contenue dans p + i*taille (element pointe par p) 

ct : 

p2 - pi = (adresse contenue dans p2 - adresse contenue dans pi) / 
taille (elements pointes par pi et p2) 



Si p est un pointeur d'entier, p+l est done le pointeur sur l'entier qui suit immediatement celui pointe 
par p. On retiendra surtout que l'entier qu'on additionne au pointeur est multiplie par la taille de 
l'element pointe pour obtenir la nouvelle adresse. 

Le type du resultat de la soustraction de deux pointeurs est tres dependant de la machine cible et du 
modele memoire du programme. En general, on ne pourra jamais supposer que la soustraction de deux 
pointeurs est un entier (que les chevronnes du C me pardonnent, mais e'est une erreur tres grave). En 
effet, ce type peut etre insuffisant pour stocker des adresses (une machine peut avoir des adresses sur 
64 bits et des donnees sur 32 bits). Pourresoudre ceprobleme, le fichierd'en-tete stdlib.h contient 
la definition du type a utiliser pour la difference de deux pointeurs. Ce type est nomme ptrdiffj. 

Exemple 4-10. Arithmetique des pointeurs 

int i, j; 

ptrdiff_t delta = Si - &j; /* Correct */ 

int error = Si - & j ; /* Peut marcher, mais par chance. */ 

II est possible de connaitre la taille d'un element en caracteres en utilisant l'operateur sizeof . II a la 
syntaxe d'une fonction : 

sizeof (type (expression) 



II attend soit un type, soit une expression. La valeur retournee est soit la taille du type en caracteres, 
soit celle du type de l'expression. Dans le cas des tableaux, il renvoie la taille totale du tableau. Si son 
argument est une expression, celle-ci n'est pas evaluee (done si il contient un appel a une fonction, 
celle-ci n'est pas appelee). Par exemple : 

sizeof (int) 

renvoie la taille d'un entier en caracteres, et : 
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sizeof (2 + 3) 
renvoie la meme taille, car 2 + 3 est de type entier. 2+3 n'est pas calcule. 

Note : L'operateur sizeof renvoie la taille des types en tenant compte de leur alignement. Cela 
signifie par exemple que meme si un compilateur espace les elements d'un tableau afin de les 
aligner sur des mots memoire de la machine, la taille des elements du tableau sera celle des 
objets de meme type qui ne se trouvent pas dans ce tableau (ils devront done etre alignes eux 
aussi). On a done toujours I'egalite suivante : 

sizeof (tableau) = sizeof (element ) * nombre d' elements 



4.9. Utilisation des pointeurs avec les tableaux 



Les tableaux sont etroitement lies aux pointeurs parce que, de maniere interne, Faeces aux elements 
des tableaux se fait par manipulation de leur adresse de base, de la taille des elements et de leurs 
indices. En fait, 1' adresse du n-ieme element d'un tableau est calculee avec la formule : 

Adresse_n = Adresse_Base + n*taille (element ) 

ou taille (element) represente la taille de chaque element du tableau et Adresse_Base l'adresse 
de base du tableau. Cette adresse de base est l'adresse du debut du tableau, e'est done a la fois l'adresse 
du tableau et l'adresse de son premier element. 

Ce lien apparait au niveau du langage dans les conversions implicites de tableaux en pointeurs, et dans 
le passage des tableaux en parametre des fonctions. 

4.9.1. Conversions des tableaux en pointeurs 

Afin de pouvoir utiliser l'arithmetique des pointeurs pour manipuler les elements des tableaux, le C++ 
effectue les conversions implicites suivantes lorsque necessaire : 

• tableau vers pointeur d' element ; 

• pointeur d' element vers tableau. 



Cela permet de considerer les expressions suivantes comme equivalentes : 

identif icateur [n] 

ct : 

* (identif icateur + n) 

si identif icateur est soit un identificateur de tableau, soit celui d'un pointeur. 
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tableau [3] =5; 


/ 


* (tableau+2)=4; 


/ 


pi[5]=l; 


/ 
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Exemple 4-11. Acces aux elements d'un tableau par pointeurs 

int tableau [100] ; 
int *pi=tableau; 

Le 4eme element est initialise a 5 */ 
Le 3eme element est initialise a 4 */ 
Le 5eme element est initialise a 1 */ 

Note : Le langage C++ impose que I'adresse suivant le dernier element d'un tableau doit toujours 
etre valide. Cela ne signifie absolument pas que la zone memoire references par cette adresse 
est valide, bien au contraire, mais plutot que cette adresse est valide. II est done garantit que cette 
adresse ne sera pas le pointeur NULL par exemple, ni toute autre valeur speciale qu'un pointeur 
ne peut pas stacker. II sera done possible de faire des calculs d'arithmetique des pointeurs avec 
cette adresse, meme si elle ne devra jamais etre dereferences, sous peine de voir le programme 
planter. 

On prendra garde a certaines subtilites. Les conversions implicites sont une facilite introduite par 
le compilateur, mais en realite, les tableaux ne sont pas des pointeurs, ce sont des variables 
comme les autres, a ceci pres : leur type est convertible en pointeur sur le type de leurs ele- 
ments. II en resulte parfois quelques ambigui'tes lorsqu'on manipule les adresses des tableaux. 
En particulier, on a I'egalite suivante : 

^tableau == tableau 

en raison du fait que I'adresse du tableau est la meme que celle de son premier element. II faut 
bien comprendre que dans cette expression, une conversion a lieu. Cette egalite n'est done pas 
exacte en theorie. En effet, si e'etait le cas, on pourrait ecrire : 

*&tableau == tableau 

puisque les operateurs * et & sont conjugues, d'ou : 

tableau == *&tableau = *(&tableau) == * (tableau) == t[0] 

ce qui est faux (le type du premier element n'est en general pas convertible en type pointeur.). 



4.9.2. Parametres de fonction de type tableau 

La consequence la plus importante de la conversion tableau vers pointeur se trouve dans le passage par 
variable des tableaux dans une fonction. Lors du passage d'un tableau en parametre d'une fonction, 
la conversion implicite a lieu, les tableaux sont done toujours passes par variable, jamais par valeur. 
II est done faux d'utiliser des pointeurs pour les passer en parametre, car le parametre aurait le type 
pointeur de tableau. On ne modifierait pas le tableau, mais bel et bien le pointeur du tableau. Le 
programme aurait done de fortes chances de planter. 

Par ailleurs, certaines caracteristiques des tableaux peuvent etre utilisees pour les passer en parametre 
dans les fonctions. 

II est autorise de ne pas specifier la taille de la derniere dimension des parametres de type tableau 
dans les declarations et les definitions de fonctions. En effet, la borne superieure des tableaux n'a pas 
besoin d'etre precisee pour manipuler leurs elements (on peut malgre tout la donner si cela semble 
necessaire). 
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Cependant, pour les dimensions deux et suivantes, les tailles des premieres dimensions restent neces- 
saires. Si elles n'etaient pas donnees explicitement, le compilateur ne pourrait pas connaitre le rapport 
des dimensions. Par exemple, la syntaxe : 

int tableau [ ] [ ] ; 

utilisee pour referencer un tableau de 12 entiers ne permettrait pas de faire la difference entre les 
tableaux de deux lignes et de six colonnes et les tableaux de trois lignes et de quatre colonnes (et leurs 
transposes respectifs). Une reference telle que : 

tableau [1] [3] 

ne representerait rien. Selon le type de tableau, V element reference serait le quatrieme element de 
la deuxieme ligne (de six elements), soit le dixieme element, ou bien le quatrieme element de la 
deuxieme ligne (de quatre elements), soit le huitieme element du tableau. En precisant tous les indices 
sauf un, il est possible de connaitre la taille du tableau pour cet indice a partir de la taille globale du 
tableau, en la divisant par les tailles sur les autres dimensions (2 = 12/6 ou 3 = 12/4 par exemple). 

Le programme d' exemple suivant illustre le passage des tableaux en parametre : 

Exemple 4-12. Passage de tableau en parametre 

int tab [10] [20] ; 

void test (int t [] [20] ) 
{ 

/* Utilisation de t[i][j] ... */ 

return; 



int main (void) 
{ 

test (tab) ; /* Passage du tableau en parametre. */ 

return 0; 



4.10. Les chatnes de caracteres : pointeurs et tableaux a la fois ! 

On a vu dans le premier chapitre que les chaines de caracteres n'existaient pas en C/C++. Ce sont en 
realite des tableaux de caracteres dont le dernier caractere est le caractere nul. 

Cela a plusieurs consequences. La premiere, c'est que les chaines de caracteres sont aussi des poin- 
teurs sur des caracteres, ce qui se traduit dans la syntaxe de la declaration d'une chaine de caracteres 
constante : 

const char *identif icateur = "chaine"; 



identif icateur est declare ici comme etant un pointeur de caractere, puis il est initialise avec 
l'adresse de la chaine de caracteres constante "chaine". 

La deuxieme est le fait qu'on ne peut pas faire, comme en Pascal, des affectations de chaines de 
caracteres, ni des comparaisons. Par exemple, si « noml » et « nom2 » sont des chaines de caracteres, 
F operation : 
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noml=nom2 ; 

n'estpas 1' affectation du contenu de nom2 a noml. C'est une affectation de pointeur : le pointeur noml 
est egal au pointeur nom2 et pointent sur la meme chaine ! Une modification de la chaine pointee par 
noml entraine done la modification de la chaine pointee par nom2... 

De meme, le test noml==nom2 est un test entre pointeurs, pas entre chaines de caracteres. Meme si 
deux chaines sont egales, le test sera faux si elles ne sont pas au meme emplacement memoire. 

II existe dans la bibliotheque C de nombreuses fonctions permettant de manipuler les chaines de ca- 
racteres. Par exemple, la copie d'une chaine de caracteres dans une autre se fera avec les fonctions 
strcpy et strncpy, la comparaison de deux chaines de caracteres pourra etre realisee a l'aide des 
fonctions stremp et strnemp, et la determination de la longueur d'une chaine de caracteres a l'aide 
de la fonction strlen. Je vous invite a consulter la documentation de votre environnement de de- 
veloppement ou la bibliographie pour decouvrir toutes les fonctions de manipulation des chaines de 
caracteres. Nous en verrons un exemple d'utilisation dans la section suivante. 



4.11. Allocation dynamique de memoire 

Les pointeurs sont surtout utilises pour creer un nombre quelconque de variables, ou des variables de 
taille quelconque, en cours d' execution du programme. 

En temps normal, les variables sont creees automatiquement lors de leur definition. Cela est faisable 
parce que les variables a creer ainsi que leurs tailles sont connues au moment de la compilation (c'est 
le but des declarations que d'indiquer la structure et la taille des objets, et plus generalement de donner 
les informations necessaires a leur utilisation). Par exemple, une ligne comme : 

int tableau[10000] ; 

signale au compilateur qu'une variable tableau de 10000 entiers doit etre creee. Le programme s'en 
chargera done automatiquement lors de l'execution. 

Mais supposons que le programme gere une liste de personnes. On ne peut pas savoir a 1'avance 
combien de personnes seront entrees, le compilateur ne peut done pas faire la reservation de l'espace 
memoire automatiquement. C'est au programmeur de le faire. Cette reservation de memoire (appelee 
encore allocation) doit etre faite pendant l'execution du programme. La difference avec la declaration 
de tableau precedente, c'est que le nombre de personnes et done la quantite de memoire a allouer, est 
variable. II faut done faire ce qu'on appelle une allocation dynamique de memoire. 

4.11.1. Allocation dynamique de memoire en C 

II existe deux principales fonctions C permettant de demander de la memoire au systeme 
d' exploitation et de la lui restituer. Elles utilisent toutes les deux les pointeurs, parce qu'une variable 
allouee dynamiquement n'a pas d'identificateur etant donne qu'elle n'etait a priori pas connue a la 
compilation, et n'a done pas pu etre declaree. Les pointeurs utilises par ces fonctions C n'ont pas de 
type. On les reference done avec des pointeurs non types. Leur syntaxe est la suivante : 

malloc (taille) 
free (pointeur) 



malloc (abreviation de « Memory ALLOCation ») alloue de la memoire. Elle attend comme para- 
metre la taille de la zone de memoire a allouer et renvoie un pointeur non type (void *). 
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free (pour « FREE memory ») libere la memoire allouee. Elle attend comme parametre le pointeur 
sur la zone a liberer et ne renvoie rien. 

Lorsqu'on alloue une variable typee, on doit faire un transtypage du pointeur renvoye par malloc en 
pointeur de ce type de variable. 

Pour utiliser les fonctions malloc et free, vous devez mettre au debut de votre programme la ligne : 

#include <stdlib.h> 



Son role est similaire a celui de la ligne #include <stdio .h>. Vous verrez sa signification dans 
le chapitre concernant le preprocesseur. 

L'exemple suivant va vous presenter un programme C classique qui manipule des pointeurs. Ce pro- 
gramme realise des allocations dynamiques de memoire et manipule une liste de structures dyna- 
miquement, en fonction des entrees que fait l'utilisateur. Les techniques de saisies de parametres 
presentees dans le premier chapitre sont egalement revues. Ce programme vous presente aussi com- 
ment passer des parametres par variable, soit pour optimiser le programme, soit pour les modifier au 
sein des fonctions appelees. Enfin, l'utilisation du mot clef const avec les pointeurs est egalement 
illustree. 

Exemple 4-13. Allocation dynamique de memoire en C 

#include <stdio.h> /* Autorise l'utilisation de printf 

et de scanf. */ 
tinclude <stdlib.h> /* Autorise l'utilisation de malloc 

et de free. */ 
#include <string.h> /* Autorise l'utilisation de strcpy, 

strlen et de strcmp. */ 

/* Type de base d' un element de liste de personne . */ 

typedef struct person 

{ 

char *name; /* Norn de la personne. */ 

char *address; /* Adresse de la personne. */ 

struct person *next; /* Pointeur sur 1' element suivant. */ 

} Person; 

typedef Person *People; /* Type de liste de personnes. */ 
/* Fonctions de gestion des listes de personnes : */ 

/* Fonction d' initialisation d'une liste de personne. 

La liste est passee par variable pour permettre son initialisation. */ 
void init_list (People *lst) 
{ 

*lst = NULL; 



/* Fonction d'ajout d'une personne. Les parametres de la personne 
sont passes par variables, mais ne peuvent etre modifies car 
ils sont constants. Ce sont des chaines de caracteres C, qui 
sont done assimilees a des pointeurs de caracteres constants. */ 

int add_person (People *lst, const char *name, const char *address) 

{ 

/* Cree un nouvel element : */ 
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Person *p = (Person *) malloc (sizeof (Person) ) ; 

if (p != NULL) 

{ 

/* Alloue la memoire pour le nom et l'adresse. Attention, 

il faut compter le caractere nul terminal des chaines : */ 
p->name = (char *) malloc (( strlen (name) + 1) * sizeof (char) ) ; 
p->address = (char *) malloc ( (strlen (address) + 1) * sizeof (char) ) ; 
if (p->name != NULL && p->address != NULL) 
{ 

/* Copie le nom et l'adresse : */ 
strcpy (p->name, name); 
strcpy (p->address, address); 
p->next = *lst; 
*lst = p; 
} 

else 
{ 

free (p) ; 
p = NULL; 
} 
} 
return (p != NULL) ; 



/* Fonction de suppression d'une personne. 

La structure de la liste est modifiee par la suppression 
de 1' element de cette personne. Cela peut impliquer la modification 
du chainage de 1' element precedent, ou la modification de la tete 
de liste elle-meme. */ 
int remove_person (People *lst, const char *name) 
{ 

/* Recherche la personne et son antecedant : */ 

Person *prev = NULL; 

Person *p = *lst; 

while (p != NULL) 

{ 

/* On sort si 1' element courant est la personne recherchee : */ 
if ( strcmp (p->name, name) == 0) 

break; 
/* On passe a 1' element suivant sinon : */ 
prev = p; 
p = p->next; 
} 

if (p != NULL) 
{ 

/* La personne a ete trouvee, on la supprime de la liste : */ 

if (prev == NULL) 

{ 

/* La personne est en tete de liste, on met a jour 

le pointeur de tete de liste : */ 
*lst = p->next; 
} 

else 
{ 

/* On met a jour le lien de 1' element precedent : */ 
prev->next = p->next; 
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I* et on la detruit : */ 
free (p->name) ; 
free (p->address) ; 
free (p) ; 
} 

return (p != NULL) ; 
} 

/* Simple fonction d' af f ichage . */ 
void print_list (People const *lst) 
{ 

Person const *p = *lst; 

int 1=1; 

while (p != NULL) 

{ 

print f ( "Personne %d : %s (%s)\n", i, p->name, p->address ) ; 
p = p->next; 
+ + i; 
} 



/* Fonction de destruction et de liberation de la memoire. */ 

void destroy_list (People *lst) 

{ 

while (*lst != NULL) 
{ 

Person *p = *lst; 
*lst = p->next; 
free (p->name) ; 
free (p->address) ; 
free (p) ; 
} 
return ; 



int main (void) 
{ 

int op = 0; 

size_t s; 

char buffer [16]; 

char name [256] ; 

/* Cree une liste de personne : */ 

People p; 

init_list (&p) ; 

/* Utilise la liste : */ 

do 

{ 

print f ( "Operation (0 = quitter, 1 = ajouter, 2 = supprimer) 

fgets (buffer, 16, stdin) ; 

buffer[15] = 0; 

op = 3 ; 

sscanf (buffer, "%d", Sop) ; 

switch (op) 

{ 

case : 

break; 

case 1 : 
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print f ( "Nom : "); 

fgets (name, 256, stdin) ; /* Lit le nom. */ 

name [255] = 0; /* Assure que le caractere nul 

terminal est ecrit . */ 
s = strlen (name) ; /* Supprime 1'eventuel saut de ligne. */ 

if (name[s - 1] == ' \n' ) name[s - 1] = 0; 
/* Merae operation pour 1'adresse : */ 
printf ( "Adresse : "); 
fgets (address, 256, stdin) ; 
name [255] = 0; 
s = strlen (address) ; 

if (address [s - 1] == ' \n' ) address [s - 1] = 0; 
add_person (&p, name, address); 
break; 
case 2 : 

printf ("Nom : "); 

fgets (name, 256, stdin); 

name [255] = ; 

s = strlen(name); 

if (name[s - 1] == ' \n' ) name[s - 1] = 0; 

if (remove_person (&p, name) == 0) 

{ 

print f ("Personne inconnue . \n" ) ; 
} 

break; 
default : 

printf ("Operation invalide\n" ) ; 
break; 
} 

if (op != 0) print_list (&p) ; 
} while (op != 0) ; 
/* Detruit la liste : */ 
destroy_list (&p) ; 
return 0; 



Note : Comme vous pouvez le constater, la lecture des chaines de caracteres saisies par 
I'utilisateur est realisee au moyen de la fonction fgets de la bibliotheque C standard. Cette 
fonction permet de lire une ligne complete sur le flux specifie en troisieme parametre, et de 
stacker le resultat dans la chaine de caracteres fournie en premier parametre. Elle ne lira pas 
plus de caracteres que le nombre indique en deuxieme parametre, ce qui permet de controler la 
taille des lignes saisies par I'utilisateur. La fonction fgets necessite malheureusement quelques 
traitements supplementaires avant de pouvoir utiliser la chame de caracteres lue, car elle n'ecrit 
pas le caractere nul terminal de la chaine C si le nombre maximal de caracteres a lire est atteint, 
et elle stocke le caractere de saut de ligne en fin de ligne si ce nombre n'est pas atteint. II 
est done necessaire de s'assurer que la ligne se termine bien par un caractere nul terminal 
d'une part, et de supprimer le caractere de saut de ligne s'il n'est pas essentiel d'autre part. 
Ces traitements constituent egalement un bon exemple de manipulation des pointeurs et des 
chaines de caracteres. 

Ce programme n'interdit pas les definitions multiples de personnes ayant le meme nom. II 
n'interdit pas non plus la definition de personnes anonymes. Le lecteur pourra essayer de 
corriger ces petits defauts a titre d'exercice, afin de s'assurer que les notions de pointeur sont 
bien assimilees. Rappelons que les pointeurs sont une notion essentielle en C et qu'il faut etre 
done parfaitement familiarise avec eux. 
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4.11.2. Allocation dynamique en C++ 

En plus des fonctions malloc et free du C, le C++ fournit d'autres moyens pour allouer et restituer 
la memoire. Pour cela, il dispose d' operateurs specifiques : new, delete, new [ ] et delete [ ] . La 
syntaxe de ces operateurs est respectivement la suivante : 

new type 
delete pointeur 
new type[taille] 
delete [] pointeur 



Les deux operateurs new et new [ ] permettent d'allouer de la memoire, et les deux operateurs delete 

et delete [ ] de la restituer. 

La syntaxe de new est tres simple, il suffit de faire suivre le mot cle new du type de la variable a allouer, 
et l'operateur renvoie directement un pointeur sur cette variable avec le bon type. II n'est done plus 
necessaire d'effectuer un transtypage apres F allocation, comme e'etait le cas pour la fonction malloc. 
Par exemple, F allocation d'un entier se fait comme suit : 

int *pi = new int; // Equivalent a (int *) malloc (sizeof (int ) ) . 



La syntaxe de delete est encore plus simple, puisqu'il suffit de faire suivre le mot cle delete du 
pointeur sur la zone memoire a liberer : 

delete pi; // Equivalent a free (pi) ; 



Les operateurs new [ ] et delete [ ] sont utilises pour allouer et restituer la memoire pour les types 
tableaux. Ce ne sont pas les memes operateurs que new et delete, et la memoire allouee par les uns 
ne peut pas etre liberee par les autres. Si la syntaxe de delete [ ] est la meme que celle de delete, 
Femploi de l'operateur new [ ] necessite de donner la taille du tableau a allouer. Ainsi, on pourra creer 
un tableau de 10000 entiers de la maniere suivante : 

int *Tableau=new int [10000]; 

et detruire ce tableau de la maniere suivante : 

delete [ ] Tableau; 



Note : L'operateur new[] ne permet d'allouer que des tableaux a une dimension. Pour allouer 
des tableaux a plusieurs dimensions, on devra soit allouer un tableau de pointeurs pour chaque 
dimension et allouer les elements une fois arrive a la derniere dimension, soit allouer un tableau 
a une dimension contenant le nombre total d'elements du tableau et faire un transtypage ensuite. 

II est important d'utiliser l'operateur delete [ ] avec les pointeurs renvoyes par l'operateur new [ ] 
et l'operateur delete avec les pointeurs renvoyes par new. De plus, on ne devra pas non plus 
melanger les mecanismes d'allocation memoire du C et du C++ (utiliser delete sur un pointeur 
renvoye par maiioc par exemple). En effet, le compilateur peut allouer une quantite de memoire 
superieure a celle demandee par le programme afin de stocker des donnees qui lui permettent 
de gerer la memoire. Ces donnees peuvent etre interpreters differemment pour chacune des 
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methodes d'allocation, si bien qu'une utilisation erronee peut entramer soit la perte des blocs de 
memoire, soit une erreur, soit un plantage. 



L'operateur new [ ] alloue la memoire et cree les objets dans l'ordre croissant des adresses. Inverse- 
ment, l'operateur delete [ ] detruit les objets du tableau dans l'ordre decroissant des adresses avant 
de liberer la memoire. 

La maniere dont les objets sont construits et detruits par les operateurs new et new [ ] depend de leur 
nature. S'il s'agit de types de base du langage ou de structures simples, aucune initialisation particu- 
liere n'est faite. La valeur des objets ainsi crees est done indefinie, et il faudra realiser l'initialisation 
soi-meme. Si, en revanche, les objets crees sont des instances de classes C++, le constructeur de ces 
classes sera automatiquement appele lors de leur initialisation. C'est pour cette raison que Ton de- 
vra, de maniere generale, preferer les operateurs C++ d'allocation et de deallocation de la memoire 
aux fonctions malloc et free du C. Ces operateurs ont de plus l'avantage de permettre un meilleur 
controle des types de donnees et d'eviter un transtypage. Les notions de classe et de constructeur 
seront presentees en detail dans le chapitre traitant de la couche objet du C++. 

Lorsqu'il n'y a pas assez de memoire disponible, les operateurs new et new [ ] peuvent se comporterde 
deux manieres selon F implementation. Le comportement le plus repandu est de renvoyer un pointeur 
nul. Cependant, la norme C++ indique un comportement different : si l'operateur new manque de 
memoire, il doit appeler un gestionnaire d'erreur. Ce gestionnaire ne prend aucun parametre et ne 
renvoie rien. Selon le comportement de ce gestionnaire d'erreur, plusieurs actions peuvent etre faites : 



soit ce gestionnaire peut corriger l'erreur d'allocation et rendre la main a l'operateur new ( le 
programme n'est done pas termine), qui effectue une nouvelle tentative pour allouer la memoire 
demandee ; 

soit il ne peut rien faire. Dans ce cas, il peut mettre fin a l'execution du programme ou lancer 
une exception std: :bad_alloc, qui remonte alors jusqu'a la fonction appelant l'operateur new. 
C'est le comportement du gestionnaire installe par defaut dans les implementations conformes a la 
norme. 



L'operateur new est done susceptible de lancer une exception std: :bad_alloc. Voir le Chapitre 9 
pour plus de details a ce sujet. 

II est possible de remplacer le gestionnaire d'erreur appele par l'operateur new a l'aide de la fonction 
std : : set_new_handler, declaree dans le fichier d'en-tete new. Cette fonction attend en parametre 
un pointeur sur une fonction qui ne prend aucun parametre et ne renvoie rien. Elle renvoie l'adresse 
du gestionnaire d'erreur precedent. 

Note : La fonction std: :set_new_handier et la classe std::bad_alloc font partie de la biblio- 
theque standard C++. Comme leurs noms I'indiquent, ils sont declares dans I'espace de nom- 
mage std: : , qui est reserve pour les fonctions et les classes de la bibliotheque standard. Voyez 
aussi le Chapitre 1 1 pour plus de details sur les espaces de nommages. Si vous ne desirez pas 
utiliser les mecanismes des espaces de nommage, vous devrez inclure le fichier d'en-tete new.h 
au lieu de new. 

Attendez vous a ce qu'un jour, tous les compilateurs C++ lancent une exception en cas de 
manque de memoire lors de I'appel a l'operateur new, car c'est ce qu'impose la norme. Si vous 
ne desirez pas avoir a gerer les exceptions dans votre programme et continuer a recevoir un 
pointeur nul en cas de manque de memoire, vous pouvez fournir un deuxieme parametre de type 
std::nothrow_t a l'operateur new. La bibliotheque standard definit I'objet constant std: :nothrow 
a cet usage. 
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Les operateurs delete et delete [ ] peuvent parfaitement etre appeles avec un pointeur nul en para- 
metre. Dans ce cas, ils ne font rien et redonnent la main immediatement a F appelant. II n'est done pas 
necessaire de tester la non nullite des pointeurs sur les objets que Ton desire detruire avant d'appeler 
les operateurs delete et delete [ ] . 



4.12. Pointeurs et references de fonctions 



4.12.1. Pointeurs de fonctions 

II est possible de faire des pointeurs de fonctions. Un pointeur de fonction contient l'adresse du 
debut du code binaire constituant la fonction. II est possible d'appeler une fonction dont l'adresse est 
contenue dans un pointeur de fonction avec l'operateur d'indirection *. 

Pour declarer un pointeur de fonction, il suffit de considerer les fonctions comme des variables. Leur 
declaration est identique a celle des tableaux, en remplacant les crochets par des parentheses : 

type (*identif icateur) (parametres); 

ou type est le type de la valeur renvoyee par la fonction, identif icateur est le nom du poin- 
teur de la fonction et parametres est la liste des types des variables que la fonction attend comme 
parametres, separes par des virgules. 

Exemple 4-14. Declaration de pointeur de fonction 

int (*pf) (int, int); /* Declare un pointeur de fonction. */ 

pf est un pointeur de fonction attendant comme parametres deux entiers et renvoyant un entier. 
II est possible d'utiliser typedef pour creer un alias du type pointeur de fonction : 

typedef int (*PtrFonct) (int, int); 

PtrFonct pf; 



PtrFonct est le type des pointeurs de fonctions. 

Si f est une fonction repondant a ces criteres, on peut alors initialiser pf avec l'adresse de f . De 
meme, on peut appeler la fonction pointee par pf avec l'operateur d'indirection. 

Exemple 4-15. Dereferencement de pointeur de fonction 

#include <stdio.h> /* Autorise l'emploi de scanf et de printf. */ 

int f (int i, int j) /* Definit une fonction. */ 

{ 

return i+j; 
} 

int (*pf) (int, int); /* Declare un pointeur de fonction. */ 

int main (void) 
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int 1, m; /* Declare deux entiers. */ 

pf = &f; /* Initialise pf avec l'adresse de la fonction f. */ 

print f ( "Entrez le premier entier : " ) ; 

scant ( "%u" , &1 ) ; /* Initialise les deux entiers. */ 

print f (" \nEntrez le deuxieme entier : "); 

scant ( "%u" , &m) ; 

/* Utilise le pointeur pf pour appeler la fonction f 
et affiche le resultat : */ 

print f (" \nLeur somme est de : %u\n", (*pf) (l,m)); 
return 0; 



L'interet des pointeurs de fonction est de permettre l'appel d'une fonction parmi un eventail de fonc- 
tions au choix. 

Par exemple, il est possible de faire un tableau de pointeurs de fonctions et d' appeler la fonction dont 
on connait l'indice de son pointeur dans le tableau. 

Exemple 4-16. Application des pointeurs de fonctions 

tinclude <stdio.h> /* Autorise l'emploi de scanf et de printf. */ 

/* Definit plusieurs fonctions travaillant sur des entiers : */ 

int somme (int i, int j) 
{ 

return i+j; 
} 

int multiplication ( int i, int j) 
{ 

return i*j; 
} 

int quotient (int i, int j) 
{ 

return i/j; 
} 

int modulo (int i, int j) 
{ 

return i%j; 

} 

typedef int (*fptr) (int, int); 
fptr ftab[4] ; 

int main (void) 
{ 

int i, j , n; 

ftab [0] =&somme; /* Initialise le tableau de pointeur */ 

ftab [1] =&multiplication; /* de fonctions. */ 

ftab [2 ]=& quotient ; 

ftab [3] =&modulo; 
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print f ( "Entrez le premier entier : "); 

scanf ( "%u" , &i ) ; /* Demande les deux entiers i et j. */ 

print f (" \nEntrez le deuxieme entier : "); 

scanf ("%u", & j) ; 

print f (" \nEntrez la fonction : "); 

scanf ( "%u" , &n) ; /* Demande la fonction a appeler. */ 

if (n < 4) 

printf ("\nResultat : %u.\n", ( * ( f tab [n] ) ) (i, j ) ); 
else 

print f (" \nMauvais numero de f onction . \n" ) ; 
return 0; 



4.12.2. References de fonctions 

Les references de fonctions sont acceptees en C++. Cependant, leur usage est assez limite. Elles 
permettent parfois de simplifier les ecritures dans les manipulations de pointeurs de fonctions. Mais 
comme il n'est pas possible de definir des tableaux de references, le programme d'exemple donne 
ci-dessus ne peut pas etre recrit avec des references. 

Les references de fonctions peuvent malgre tout etre utilisees a profit dans le passage des fonctions 
en parametre dans une autre fonction. Par exemple : 

tinclude <stdio.h> // Autorise l'emploi de scanf et de printf. 

// Fonction de comparaison de deux entiers : 

int compare (int i, int j) 
{ 

if (i<j) return -1; 

else if (i>j) return 1; 

else return 0; 
} 

// Fonction utilisant une fonction en tant que parametre : 

void trie (int tableau!], int taille, int (Sfcomp) (int, int)) 
{ 

// Effectue le tri de tableau avec la fonction fcomp. 

// Cette fonction peut etre appelee comme toute les autres 

// fonctions : 

printf ("%d", f comp (2 , 3) ) ; 

return ; 
} 

int main (void) 
{ 

int t [3]={1, 5,2}; 

trie(t, 3, compare); // Passage de compare () en parametre. 

return 0; 
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4.13. Parametres de la fonction main - ligne de commande 

L'appel d'un programme se fait normalement avec la syntaxe suivante : 

nom paraml param2 [ . . . ] 

ou nom est le nom du programme a appeler et paraml, etc. sont les parametres de la ligne de com- 
mande. De plus, le programme appele peut renvoyer un code d'erreur au programme appelant (soit 
le systeme d' exploitation, soit un autre programme). Ce code d'erreur est en general quand le pro- 
gramme s'est deroule correctement. Toute autre valeur indique qu'une erreur s'est produite en cours 
d' execution. 

La valeur du code d'erreur est renvoyee par la fonction main. Le code d'erreur doit toujours etre un 
entier. La fonction main peut done (et meme normalement doit) etre de type entier : 

int main (void) . . . 



Les parametres de la ligne de commandes peuvent etre recuperes par la fonction main. Si vous desirez 
les recuperer, la fonction main doit attendre deux parametres : 

• le premier est un entier, qui represente le nombre de parametres ; 

• le deuxieme est un tableau de chaines de caracteres (done en fait un tableau de pointeurs, ou encore 
un pointeur de pointeurs de caracteres). 



Les parametres se recuperent avec ce tableau. Le premier element pointe toujours sur la chaine don- 
nant le nom du programme. Les autres elements pointent sur les parametres de la ligne de commande. 

Exemple 4-17. Recuperation de la ligne de commande 

tinclude <stdio.h> /* Autorise 1' utilisation des fonctions */ 

/* printf et scant. */ 

int main(int n, char *params [ ] ) /* Fonction principale. */ 
{ 

int i; 

/* Affiche le nom du programme : */ 

printf ("Nom du programme : %s . \n" , params [ ] ) ; 

/* Affiche la ligne de commande : */ 
for (i=l; i<n; ++i) 

printf ( "Argument %d : %s.\n",i, params [i] ) ; 
return 0; /* Tout s'est bien passe : on renvoie ! */ 



4.14. DANGER 

Les pointeurs sont, comme on l'a vu, tres utilises en C/C++. II faut done bien savoir les manipuler. 

Mais ils sont tres dangereux, car ils permettent d'acceder a n'importe quelle zone memoire, s'ils ne 
sont pas correctement initialises. Dans ce cas, ils pointent n'importe ou. Acceder a la memoire avec 
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un pointeur non initialise peut alterer soit les donnees du programme, soit le code du programme 
lui-meme, soit le code d'un autre programme ou celui du systeme d' exploitation. Cela conduit dans 
la majorite des cas au plantage du programme, et parfois au plantage de l'ordinateur si le systeme ne 
dispose pas de mecanismes de protection efficaces. 

VEILLEZ A TOUJOURS INITIALISER LES POINTEURS QUE VOUS 

UTILISEZ. 



Pour initialiser un pointeur qui ne pointe sur rien (c'est le cas lorsque la variable pointee n'est pas 
encore creee ou lorsqu'elle est inconnue lors de la declaration du pointeur), on utilisera le pointeur 
predefini null. 

VERIFIEZ QUE TOUTE DEMANDE D' ALLOCATION MEMOIRE A ETE 

SATISFAITE. 



La fonction malloc renvoie le pointeur null lorsqu'il n'y a plus ou pas assez de memoire. Le com- 
portement des operateurs new et new [ ] est different. Theoriquement, ils doivent lancer une exception 
si la demande d' allocation memoire n'a pas pu etre satisfaite. Cependant, certains compilateurs font 
en sorte qu'ils renvoient le pointeur nul du type de l'objet a creer. 

S'ils renvoient une exception, le programme sera arrete si aucun traitement particulier n'est fait. Bien 
entendu, le programme peut traiter cette exception s'il le desire, mais en general, il n'y a pas grand 
chose a faire en cas de manque de memoire. Vous pouvez consulter le chapitre traitant des exceptions 
pour plus de details a ce sujet. 

Dans tous les cas, 

LORSQU'ON UTILISE UN POINTEUR, IL FAUT VERIFIER S'IL EST VALIDE 

(par un test avec null ou le pointeur nul, ou en analysant l'algorithme). Cette verification inclut le 
test de debordement lors des acces aux chaines de caracteres et aux tableaux. Cela est extremement 
important lorsque Ton manipule des donnees provenant de 1'exterieur du programme, car on ne peut 
dans ce cas pas supposer que ces donnees sont valides. 
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5.1. Definition 



Le preprocesseur est un programme qui analyse un fichier texte et qui lui fait subir certaines transfor- 
mations. Ces transformations peuvent etre V inclusion d'un fichier, la suppression d'une zone de texte 
ou le remplacement d'une zone de texte. 

Le preprocesseur effectue ces operations en suivant des ordres qu'il lit dans le fichier en cours 
d' analyse. 

II est appele automatiquement par le compilateur, avant la compilation, pour traiter les fichiers a 
compiler. 



5.2. Les commandes du preprocesseur 

Toutes les commandes du preprocesseur commencent : 

• en debut de ligne ; 

• par un signe diese (#). 

Les commandes sont les suivantes : 

5.2.1. Inclusion de fichier 

L inclusion de fichier permet de factoriser du texte commun a plusieurs autres fichiers (par exemple 
des declarations de type, de constante, de fonction, etc.). Le texte commun est mis en general dans un 
fichier portant l'extension . h (pour « header », fichier d'en-tete de programme). 

Syntaxe : 

♦include "fichier" 

ou : 

♦include <fichier> 



fichier est le nom du fichier a inclure. Lorsque son nom est entre guillemets, le fichier specifie est 
recherche dans le repertoire courant (normalement le repertoire du programme). S'il est encadre de 
crochets, il est recherche d'abord dans les repertoires specifies en ligne de commande avec l'option 
-I, puis dans les repertoires du chemin de recherche des en-tetes du systeme (ces regies ne sont pas 
fixes, elles ne sont pas normalisees). 

Le fichier inclus est traite lui aussi par le preprocesseur. 

La signification de la ligne #include <stdio.h> au debut de tous les programmes utilisant les 
fonctions scanf et printf devient alors claire. Si vous ouvrez le fichier stdio . h, vous y verrez la 
declaration de toutes les fonctions et de tous les types de la bibliotheque d' entree - sortie standard. De 
meme, les fonctions malloc et free sont declarees dans le fichier d'en-tete stdlib.h et definies 
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dans la bibliotheque standard. L' inclusion de ces fichiers permet done de declarer ces fonctions afin 
de les utiliser. 



5.2.2. Constantes de compilation et remplacement de texte 

Le preprocesseur permet de definir des identificateurs qui, utilises dans le programme, seront rempla- 
ces textuellement par leur valeur. La definition de ces identificateurs suit la syntaxe suivante : 

#define identif icateur texte 

ou identif icateur est l'identificateur qui sera utilise dans la suite du programme, et texte sera 
le texte de remplacement que le preprocesseur utilisera. Le texte de remplacement est facultatif (dans 
ce cas, e'est le texte vide). A chaque fois que l'identificateur identif icateur sera rencontre par le 
preprocesseur, il sera remplace par le texte texte dans toute la suite du programme. 

Cette commande est couramment utilisee pour definir des constantes de compilation, e'est-a-dire des 
constantes qui decrivent les parametres de la plate-forme pour laquelle le programme est compile. Ces 
constantes permettent de realiser des compilations conditionnelles, e'est-a-dire de modifier le com- 
portement du programme en fonction de parametres definis lors de sa compilation. Elle est egalement 
utilisee pour remplacer des identificateurs du programme par d'autres identificateurs, par exemple 
afin de tester plusieurs versions d'une meme fonction sans modifier tout le programme. 

Exemple 5-1. Definition de constantes de compilation 

#define UNIX_SOURCE 
#define POSIX_VERSION 1001 

Dans cet exemple, l'identificateur unix_source sera defini dans toute la suite du programme, et la 
constante de compilation posix_version sera remplacee par 1001 partout ou elle apparaitra. 

Note : On fera une distinction bien nette entre les constantes de compilation definies avec la 
directive #define du preprocesseur et les constantes definies avec le mot cle const. En ef- 
fet, les constantes litterales ne reservent pas de memoire. Ce sont des valeurs immediates, 
definies par le compilateur. En revanche, les variables de classe de stockage const peuvent 
malgre tout avoir une place memoire reservee. Ce peut par exemple etre le cas si Ton manipule 
leur adresse ou s'il ne s'agit pas de vraies constantes, par exemple si elles peuvent etre modi- 
fies par I'environnement (dans ce cas, elles doivent etre declarees avec la classe de stockage 
volatile). Ce sont done plus des variables accessibles en lecture seule que des constantes. On 
ne pourra jamais supposer qu'une variable ne change pas de valeur sous pretexte qu'elle a la 
classe de stockage const, alors qu'evidemment, une constante litterale declaree avec la directive 
#def ine du preprocesseur conservera toujours sa valeur (pourvu qu'on ne la redefinisse pas). 
Par ailleurs, les constantes litterales n'ont pas de type, ce qui peut etre tres genant et source 
d'erreur. On reservera done leur emploi uniquement pour les constantes de compilation, et on 
preferera le mot cle const pour toutes les autres constantes du programme. 



Le preprocesseur definit un certain nombre de constantes de compilation automatiquement. Ce sont 
les suivantes : 



_line : donne le numero de la ligne courante ; 

_file : donne le nom du fichier courant ; 

_date : renvoie la date du traitement du fichier par le preprocesseur ; 
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time : renvoie l'heure du traitement du fichier par le preprocesseur ; 

cplusplus : definie uniquement dans le cas d'une compilation C++. Sa valeur doit etre 

199711L pour les compilateurs compatibles avec le projet de norme du 2 decembre 1996. En 
pratique, sa valeur est dependante de 1' implementation utilisee, mais on pourra utiliser cette 
chaine de remplacement pour distinguer les parties de code ecrites en C++ de celles ecrites en C. 



Note : Si file , date , time et cpiuspius sont bien des constantes pour un 

fichier donne, ce n'est pas le cas de line . En effet, cette derniere « constante » change bien 

evidemment de valeur a chaque ligne. On peut considerer quelle est redefinie automatiquement 
par le preprocesseur a chaque debut de ligne. 



5.2.3. Compilation conditionnelle 

La definition des identificateurs et des constantes de compilation est tres utilisee pour effectuer ce 
que Ton appelle la compilation conditionnelle. La compilation conditionnelle consiste a remplacer 
certaines portions de code source par d'autres, en fonction de la presence ou de la valeur de constantes 
de compilation. Cela est realisable a l'aide des directives de compilation conditionnelle, dont la plus 
courante est sans doute fifdef : 

fifdef identif icateur 
#endif 



Dans l'exemple precedent, le texte compris entre le #ifdef (c'est-a-dire « if defined ») et le #en- 
dif est laisse tel quel si l'identificateur identif icateur est connu du preprocesseur. Sinon, il est 
supprime. L'identificateur peut etre declare en utilisant simplement la commande #def ine vue pre- 
cedemment. 

II existe d'autres directives de compilation conditionnelle : 

#ifndef (if not defined ...) 
#elif (sinon, si ... ) 
#if (si ... ) 

La directive #if attend en parametre une expression constante. Le texte qui la suit est inclus dans le 
fichier si et seulement si cette expression est non nulle. Par exemple : 



#if ( cplusplus==199711L) 

tendif 

permet d'inclure un morceau de code C++ strictement conforme a la norme decrite dans le projet de 
norme du 2 decembre 1996. 

Une autre application courante des directives de compilation est la protection des fichiers d'en-tete 
contre les inclusions multiples : 

#ifndef DejaLa 
#define DejaLa 
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Texte a n' inclure qu'une seule fois au plus. 

tendif 

Cela permet d'eviter que le texte soit inclus plusieurs fois, a la suite de plusieurs appels de #include. 
En effet, au premier appel, De jaLa n'est pas connu du preprocesseur. II est done declare et le texte 
est inclus. Lors de tout autre appel ulterieur, De jaLa existe, et le texte n'est pas inclus. Ce genre 
d'ecriture se rencontre dans les fichiers d'en-tete, pour lesquels en general on ne veut pas qu'une 
inclusion multiple ait lieu. 



5.2.4. Autres commandes 

Le preprocesseur est capable d'effectuer d' autres actions que 1' inclusion et la suppression de texte. 
Les directives qui permettent d'effectuer ces actions sont indiquees ci-dessous : 

• # : ne fait rien (directive nulle) ; 

terror message : permet de stopper la compilation en affichant le message d'erreur donne en 
parametre ; 

• tline numero [fichier] : permet de changer le numero de ligne courant et le nom du fichier 
courant lors de la compilation ; 

• #pragma texte : permet de donner des ordres specifiques a une 1' implementation du compilateur 
tout en conservant la portabilite du programme. Toute implementation qui ne reconnait pas un ordre 
donne dans une directive #pragma doit l'ignorer pour eviter des messages d'erreurs. Le format des 
ordres que Ton peut specifier a l'aide de la directive #pragma n'est pas normalise et depend de 
chaque compilateur. 



5.3. Les macros 



Le preprocesseur peut, lors du mecanisme de remplacement de texte, utiliser des parametres fournis 
a l'identificateur a remplacer. Ces parametres sont alors replaces sans modification dans le texte de 
remplacement. Le texte de remplacement est alors appele macro. 

La syntaxe des macros est la suivante : 

tdefine macro (parametre [ , parametre [...]]) definition 



Exemple 5-2. Macros MIN et MAX 

tdefine MAX(x,y) ( (x) >(y) ? (x) : (y) ) 
tdefine MIN(x,y) ( (x)< (y) ? (x) : (y) ) 



Note : Pour poursuivre une definition sur la ligne suivante, terminez la ligne courante par le signe 
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Le mecanisme des macros permet de faire l'equivalent de fonctions generates, qui fonctionnent pour 
tous les types. Ainsi, la macro max renvoie le maximum de ses deux parametres, qu'ils soient entiers, 
longs ou reels. Cependant, on prendra garde au fait que les parametres passes a une macro sont 
evalues par celle-ci a chaque fois qu'ils sont utilises dans la definition de la macro. Cela peut poser 
des problemes de performances ou, pire, provoquer des effets de bords indesirables. Par exemple, 
1' utilisation suivante de la macro min : 

MIN(f(3), 5) 

provoque le remplacement suivant : 

( (f (3) )<(5) ) ?(f (3) ) : (5) ) 

soit deux appels de la fonction f si f ( 3 ) est inferieur a 5, et un seul appel sinon. Si la fonction f ainsi 
appelee modifie des variables globales, le resultat de la macro ne sera certainement pas celui attendu, 
puisque le nombre d' appels est variable pour une meme expression. On evitera done, autant que faire 
se peut, d'utiliser des expressions ayant des effets de bords en parametres d'une macro. Les ecritures 
du type : 

MIN(++i, j) 

sont done a prohiber. 

On mettra toujours des parentheses autour des parametres de la macro. En effet, ces parametres 
peuvent etre des expressions composees, qui doivent etre calculees completement avant d'etre uti- 
lisees dans la macro. Les parentheses forcent ce calcul. Si on ne les met pas, les regies de priorites 
peuvent generer une erreur de logique dans la macro elle-meme. De meme, on entourera de paren- 
theses les macros renvoyant une valeur, afin de forcer leur evaluation complete avant toute utilisation 
dans une autre expression. Par exemple : 

#define mul(x,y) x*y 
est une macro fausse. La ligne : 
mul (2+3, 5+9) 
sera remplacee par : 
2+3*5+9 

ce qui vaut 2 6, et non pas 7 comme on 1'aurait attendu. La bonne macro est : 
#define mul(x,y) ( (x) * (y) ) 
car elle donne le texte suivant : 
( (2+3) * (5+9) ) 
et le resultat est correct. De meme, la macro : 

#define add(x,y) (x) + (y) 
est fausse, car l'expression suivante : 
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add (2, 3) *5 

est remplacee textuellement par : 

(2) + (3)*5 

dont le resultat est 17 et non 2 5 comme on l'aurait espere. Cette macro doit done se declarer comme 
suit : 

#define add(x,y) ( (x) + (y) ) 



Ainsi, les parentheses assurent un comportement coherent de la macro. Comme on le voit, les paren- 
theses peuvent alourdir les definitions des macros, mais elles sont absolument necessaires. 

Le resultat du remplacement d'une macro par sa definition est, lui aussi, soumis au preprocesseur. 
Par consequent, une macro peut utiliser une autre macro ou une constante definie avec #def ine. 
Cependant, ce mecanisme est limite aux macros qui n'ont pas encore ete remplacees afin d'eviter une 
recursion infinie du preprocesseur. Par exemple : 

#define toto (x) toto ( (x) +1) 

definit la macro toto. Si plus loin on utilise « toto (3) », le texte de remplacement final sera 
« toto ( (3) +1) » et non pas l'expression infinie « ( . . . ( ( (3) +1) +1 . . . ) +1 ». 

Le preprocesseur definit automatiquement la macro defined, qui permet de tester si un identificateur 
est connu du preprocesseur. Sa syntaxe est la suivante : 

defined (identificateur) 



La valeur de cette macro est 1 si 1' identificateur existe, sinon. Elle est utilisee principalement avec 
la directive #if . II est done equivalent d'ecrire : 

#if defined (identificateur) 

tendif 
et: 

tifdef identificateur 

tendif 



Cependant, defined permet 1'ecriture d'expressions plus complexes que la directive #if . 



5.4. Manipulation de chatnes de caracteres dans les macros 

Le preprocesseur permet d'effectuer des operations sur les chaines de caracteres. Tout argument de 
macro peut etre transforme en chaine de caracteres dans la definition de la macro s'il est precede du 
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signe #. Par exemple, la macro suivante : 

#define CHAINE(s) #s 

transforme son argument en chaine de caracteres. Par exemple : 

CHAINE (2+3) 

devient : 

"2 + 3" 



Lors de la transformation de 1' argument, toute occurrence des caracteres " et \ est transformee res- 
pectivement en \ " et \ \ pour conserver ces caracteres dans la chaine de caracteres de remplacement. 

Le preprocesseur permet egalement la concatenation de texte grace a l'operateur ##. Les arguments 
de la macro qui sont separes par cet operateur sont concatenes (sans etre transformes en chaines de 
caracteres cependant). Par exemple, la macro suivante : 

tdefine NOMBRE (chif f rel , chif f re2 ) chif f rel##chif f re2 
permet de construire un nombre a deux chiffres : 

NOMBRE (2,3) 

est remplace par le nombre decimal 2 3. Le resultat de la concatenation est ensuite analyse pour 
d'eventuels remplacements additionnels par le preprocesseur. 



5.5. Les trigraphes 



Le jeu de caracteres utilise par le langage C++ comprend toutes les lettres en majuscules et en minus- 
cules, tous les chiffres et les caracteres suivants : 



I 



# / \ { } [ ] < > 



Malheureusement, certains environnements sont incapables de gerer quelques-uns de ces caracteres. 
C'est pour resoudre ce probleme que les trigraphes ont ete crees. 

Les trigraphes sont des sequences de trois caracteres commencant par deux points d'interrogations. lis 
permettent de remplacer les caracteres qui ne sont pas accessibles sur tous les environnements. Vous 
n'utiliserez done sans doute jamais les trigraphes, a moins d'y etre force. Les trigraphes disponibles 
sont definis ci-dessous : 

Tableau 5-1. Trigraphes 



Trigraphe 


Caractere de remplacement 


? ?= 


# 


? ?/ 


\ 


? ? ' 


- 
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Trigraphe 


Caractere de remplacement 


? ? ( 


[ 


? ? ) 


] 


? ? ! 


l 


? ?< 


{ 


? ?> 


} 


?? — 


~ 
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Chapitre 6. Modularite des programmes et 
generation des binaires 

La modularite est le fait, pour un programme, d'etre ecrit en plusieurs morceaux relativement in- 
dependants les uns des autres. La modularite a d'enormes avantages lors du developpement d'un 
programme. Cependant, elle implique un processus de generation de l'executable assez complexe. 
Dans ce chapitre, nous allons voir l'interet de la modularite, les differentes etapes qui permettent la 
generation de l'executable et l'infiuence de ces etapes sur la syntaxe du langage. 

6.1. Pourquoi faire une programmation modulaire ? 

Ce qui coute le plus cher en informatique, c'est le developpement de logiciel, pas le materiel. En 
effet, developper un logiciel demande du temps, de la main d'oeuvre qualifiee, et n'est pas facile 
(il y a toujours des erreurs). De plus, les logiciels developpes sont souvent specifiques a un type de 
probleme donne. Pour chaque probleme, il faut tout refaire. 

Ce n'est pas un tres bon bilan. Pour eviter tous ces inconvenients, une branche de 1' informatique a 
ete developpee : le genie logiciel. Le genie logiciel donne les grands principes a appliquer lors de la 
realisation d'un programme, de la conception a la distribution, et sur toute la duree de vie du projet. 
Ce sujet depasse largement le cadre de ce cours, aussi je ne parlerais que de 1' aspect codage seul, 
c'est-a-dire ce qui concerne le C/C++. 

Au niveau du codage, le plus important est la programmation modulaire. Les idees qui en sont a la 
base sont les suivantes : 

• diviser le travail en plusieurs equipes ; 

• creer des morceaux de programme independants de la problematique globale, done reutilisables 
pour d' autres logiciels ; 

• supprimer les risques d' erreurs qu'on avait en reprogrammant ces morceaux a chaque fois. 



Je tiens a preciser que les principes de la programmation modulaire ne s'appliquent pas qu'aux pro- 
grammes developpes par des equipes de programmeurs. lis s'appliquent aussi aux programmeurs 
individuels. En effet il est plus facile de decomposer un probleme en ses elements, forcement plus 
simples, que de le traiter dans sa totalite (dixit Descartes). 

Pour parvenir a ce but, il est indispensable de pouvoir decouper un programme en sous-programmes 
independants, ou presque independants. Pour que chacun puisse travailler sur sa partie de programme, 
il faut que ces morceaux de programme soient dans des fichiers separes. 

Pour pouvoir verifier ces morceaux de programme, il faut que les compilateurs puissent les compiler 
independamment, sans avoir les autres fichiers du programme. Ainsi, le developpement de chaque 
fichier peut se faire relativement independamment de celui des autres. Cependant, cette division du 
travail implique des operations assez complexes pour generer l'executable. 



6.2. Les differentes phases du processus de generation des 
executables 

Les phases du processus qui conduisent a l'executable a partir des fichiers sources d'un programme 
sont decrites ci-dessous. Ces phases ne sont en general pas specifiques au C++, et meme si les dif- 
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ferents outils de programmation peuvent les cacher, le processus de generation des executables se 
deroule toujours selon les principes qui suivent. 

Au debut de la generation de l'executable, on ne dispose que des fichiers sources du programme, ecrit 
en C, C++ ou tout autre langage (ce qui suit n'est pas specifique au C/C++). En general, la premiere 
etape est le traitement des fichiers sources avant compilation. Dans le cas du C et du C++, il s'agit des 
operations effectuees par le preprocesseur (remplacement de macros, suppression de texte, inclusion 
de fichiers...). 

Vient ensuite la compilation separee, qui est le fait de compiler separement les fichiers sources. Le 
resultat de la compilation d' un fichier source est generalement un fichier en assembleur, c'est-a-dire le 
langage decrivant les instructions du microprocesseur de la machine cible pour laquelle le programme 
est destine. Les fichiers en assembleur peuvent etre traduits directement en ce que Ton appelle des 
fichiers objets. Les fichiers objets contiennent la traduction du code assembleur en langage machine. 
lis contiennent aussi d'autres informations, par exemple les donnees initialisees et les informations 
qui seront utilisees lors de la creation du fichier executable a partir de tous les fichiers objets generes. 
Les fichiers objets peuvent etre regroupes en bibliotheques statiques, afin de rassembler un certain 
nombre de fonctionnalites qui seront utilisees ulterieurement. 

Enfin, l'etape finale du processus de compilation est le regroupement de toutes les donnees et de tout le 
code des fichiers objets du programme et des bibliotheques (fonctions de la bibliotheque C standard et 
des autres bibliotheques complementaires), ainsi que la resolution des references inter- fichiers. Cette 
etape est appelee edition de liens (« linking » en anglais). Le resultat de l'edition de liens est le fichier 
image, qui pourra etre charge en memoire par le systeme d'exploitation. Les fichiers executables et 
les bibliotheques dynamiques sont des exemples de fichiers image. 
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Figure 6-1. Processus de generation des binaires 
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Toutes ces operations peuvent etre regroupees en une seule etape par les outils utilises. Ainsi, les com- 
pilateurs appellent generalement le preprocesseur et l'assembleur automatiquement, et realisent par- 
fois meme l'edition de liens eux-memes. Toutefois, il reste generalement possible, a l'aide d'options 
specifiques a chaque outil de developpement, de decomposer les differentes etapes et d'obtenir les 
fichiers intermediaires. 

En raison du nombre de fichiers important et des dependances qui peuvent exister entre eux, le pro- 
cessus de generation d'un programme prend tres vite une certaine ampleur. Les deux problemes les 
plus courants sont de determiner l'ordre dans lequel les fichiers et les bibliotheques doivent etre com- 
piles, ainsi que les dependances entre fichiers sources et les fichiers produits afin de pouvoir regenerer 
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correctement les fichiers images apres une modification des sources. Tous ces problemes peuvent etre 
resolus a l'aide d'un programme appele make. Le principe de make est toujours le meme, meme si 
aucune norme n'a ete definie en ce qui le concerne. make lit un fichier (le fichier (« makefile »), 
dans lequel se trouvent toutes les operations necessaires pour compiler un programme. Puis, il les 
execute si c'est necessaire. Par exemple, un fichier qui a deja ete compile et qui n'a pas ete modifie 
depuis ne sera pas recompile. C'est plus rapide. make se base sur les dates de derniere modifica- 
tion des fichiers pour savoir s'ils ont ete modifies (il compare les dates des fichiers sources et des 
fichiers produits). La date des fichiers est geree par le systeme d' exploitation : il est done important 
que l'ordinateur soit a l'heure. 



6.3. Compilation separee en C/C++ 



La compilation separee en C/C++ se fait au niveau du fichier. II existe trois grands types de fichiers 
sources en C/C++ : 



• les fichiers d'en-tete, qui contiennent toutes les declarations communes a plusieurs fichiers sources. 
Ce sont les fichiers d'en-tetes qui, en separant la declaration de la definition des symboles du 
programme, permettent de decouper l'ensemble des sources en fichiers compilables separement ; 

• les fichiers C, qui contiennent les definitions des symboles en langage C ; 

• les fichiers C++, qui contiennent les definitions des symboles en langage C++. 

On utilise une extension differente pour les fichiers C et les fichiers C++ afin de les differencier. 
Les conventions utilisees dependent du compilateur. Cependant, on peut en general etablir les regies 
suivantes : 

• les fichiers C ont 1' extension . c ; 

les fichiers C++ prennent l'extension . cc, ou . C (majuscule) sur UNIX, ou . epp sur les PC 
sous DOS ou Windows (ces deux systemes ne faisant pas la difference entre les majuscules et les 
minuscules dans leurs systemes de fichiers) ; 

• les fichiers d'en-tete ont l'extension . h, parfois . hpp (en-tete C++). 

Les programmes modulaires C/C++ auront done typiquement la structure suivante : 
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a.h 

Declaration. : 




Symbols 
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a.h 
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a.o 

Definition : 



Symbol e 











* 


a.h 








b.c 







b.o 

Reference parti ell e : 
Symbol e 



Note : II faudra bien faire la distinction entre les fichiers sources compiles separement et les 
fichiers inclus par le preprocesseur. Ces derniers sont en effet compiles avec les fichiers dans 
lesquels ils sont inclus. II n'est done pas recommande d'inclure des definitions de symboles dans 
les fichiers d'en-tete, car ces symboles risquent d'apparaitre dans plusieurs fichiers objets apres 
la compilation. Cela provoque generalement une erreur a I'edition de liens, parce que I'editeur 
de liens ne peut pas determiner quelle definition prendre parmi celles qui se trouvent dans les 
differents fichiers objets. 



6.4. Syntaxe des outils de compilation 



II existe evidemment un grand nombre de compilateurs C/C++ pour chaque plate-forme. Ils ne sont 
malheureusement pas compatibles au niveau de la ligne de commande. Le meme probleme apparait 
pour les editeurs de liens (« linker » en anglais) et pour make. Cependant, quelques principes generaux 
peuvent etre etablis. Dans la suite, je supposerai que le nom du compilateur est « cc », que celui du 
preprocesseur est « epp », celui de I'editeur de liens est « Id » et que celui de make est « make ». 

En general, les differentes etapes de la compilation et de I'edition de liens sont regroupees au niveau 
du compilateur, ce qui permet de faire les phases de traitement du preprocesseur, de compilation et 
d' edition de liens en une seule commande. Les lignes de commandes des compilateurs sont done 
souvent compliquees et tres peu portable. En revanche, la syntaxe de make est un peu plus portable. 

6.4.1. Syntaxe des compilateurs 

Le compilateur demande en general les noms des fichiers sources a compiler et les noms des fi- 
chiers objets a utiliser lors de la phase d'edition de liens. Lorsque Ton specifie un fichier source, le 
compilateur utilisera le fichier objet qu'il aura cree pour ce fichier source en plus des fichiers objets 
donnes dans la ligne de commande. Le compilateur peut aussi accepter en ligne de commande le 
chemin de recherche des bibliotheques du langage et des fichiers d'en-tete. Enfin, differentes options 
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d' optimisation sont disponibles (mais tres peu portables). La syntaxe (simplifiee) des compilateurs est 
souvent la suivante : 

cc [fichier.o [...]] [ [-c] fichier.c [...]] [-o executable] 

[-Lchemin_bibliotheques ] [-lbibliotheque [...]] [-Ichemin_include] 

f ichier . c est le nom du fichier a compiler. Si l'option -c le precede, le fichier sera compile, mais 
l'editeur de liens ne sera pas appele. Si cette option n'est pas presente, l'editeur de liens est appele, 
et le programme executable forme est enregistre dans le fichier a . out. Pour donner un autre nom a 
ce programme, il faut utiliser l'option -o, suivie du nom de l'executable. II est possible de donner 
le nom des fichiers objets deja compiles (« fichier . o ») pour que l'editeur de liens les lie avec le 
programme compile. 

L'option -L permet d'indiquer le chemin du repertoire des bibliotheques de fonctions predefinies. 
Ce repertoire sera ajoute a la liste des repertoires indiques dans la variable d'environnement LIBRA- 
RY_PATH. L'option -1 demande au compilateur d'utiliser la bibliotheque specifiee, si elle ne fait 
pas partie des bibliotheques utilisees par defaut. De meme, l'option -I permet de donner le che- 
min d'acces au repertoire des fichiers a inclure (lors de 1' utilisation du preprocesseur). Les chemins 
ajoutes avec cette option viennent s'ajouter aux chemins indiques dans les variables d'environnement 
C_INCLUDE_PATH et CPLUS_INCLUDE_PATH pour les programmes compiles respectivement en 
C et en C++. 

L'ordre des parametres sur la ligne de commande est significatif. La ligne de commande est executee 
de gauche a droite. 

Exemple 6-1. Compilation d'un fichier et edition de liens 

cc -c fichierl.c 

cc fichierl.o programme . cc -o lancez_moi 

Dans cet exemple, le fichier C f ichierl . c est compile en f ichierl . o, puis le fichier C++ pro- 
gramme . cc est compile et lie au f ichierl . o pour former l'executable lancez_moi. 



6.4.2. Syntaxe de make 

La syntaxe de make est tres simple 

make 



En revanche, la syntaxe du fichier makefile est un peu plus compliquee et peu portable. Cependant, 
les fonctionnalites de base sont gerees de la meme maniere par la plupart des programme make. 

Le fichier makefile est constitue d'une serie de lignes d'information et de lignes de commande (de 
l'interpreteur de commandes UNIX ou DOS). Les commandes doivent toujours etre precedees d'un 
caractere de tabulation horizontale. 

Les lignes d'information donnent des renseignements sur les dependances des fichiers (en particu- 
lier, les fichiers objets qui doivent etre utilises pour creer l'executable). Les lignes d'information 
permettent done a make d'identifier les fichiers sources a compiler afin de generer l'executable. 
Les lignes de commande indiquent comment effectuer cette compilation (et eventuellement d'autres 
taches). 

La syntaxe des lignes d'information est la suivante : 

nom: dependance 
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ou nom est le nom de la cible (generalement, il s'agit du nom du fichier destination), et dependance 
est la liste des noms des fichiers dont depend cette cible, separes par des espaces. La syntaxe des 
lignes de commande utilisee est celle de l'interpreteur du systeme note. Enfin, les commentaires dans 
un fichier makefile se font avec le signe diese (#). 

Exemple 6-2. Fichier makefile sans dependances 

# Compilation du fichier fichierl.c : 
cc - c fichierl.c 

# Compilation du programme principal : 
cc -o Lancez_moi fichierl.o programme. c 



Exemple 6-3. Fichier makefile avec dependances 

# Indique les dependances : 
Lancez_moi : fichierl.o programme. o 

# Indique comment compiler le programme : 

# (le symbole $@ represente le nom de la cible, ici, Lancez_moi) 
cc -o $@ fichierl.o programme. o 

♦compile les dependances : 
fichierl.o: fichierl.c 
cc -c fichierl.c 

programme. o: programmel.c 
cc -c programme. c 



6.5. Problemes syntaxiques relatifs a la compilation separee 

Pour que le compilateur puisse compiler les fichiers separement, il faut que vous respectiez les condi- 
tions suivantes : 



chaque type ou variable utilise doit etre declare ; 

toute fonction non declaree doit renvoyer un entier (en C seulement, en C++, 1' utilisation d'une 
fonction non declaree genere une erreur). 



Ces conditions ont des repercussions sur la syntaxe des programmes. Elles seront vues dans les para- 
graphes suivants. 

6.5.1. Declaration des types 

Les types doivent toujours etre definis avant toute utilisation dans un fichier source. Par exemple, il 
est interdit d'utiliser une structure client sans l'avoir definie avant sa premiere utilisation. Toutefois, il 
est possible d'utiliser un pointeur sur un type de donnee sans l'avoir completement defini. Une simple 
declaration du type de base du pointeur suffit en effet dans ce cas la. De meme, un simple class 
MaClasse suffit en C++ pour declarer une classe sans la definir completement. 
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6.5.2. Declaration des variables 

Les variables qui sont definies dans un autre fichier doivent etre declarees avant leur premiere utilisa- 
tion. Pour cela, on les specifie comme etant des variables externes, avec le mot cle extern : 

extern int i; /* i est un entier qui est declare et 
cree dans un autre fichier. 
Ici, il est simplement declare. 
*/ 



Inversement, si une variable ne doit pas etre accedee par un autre module, il faut declarer cette variable 
statique. Ainsi, meme si un autre fichier utilise le mot cle extern, il ne pourra pas y acceder. 



6.5.3. Declaration des fonctions 

Lorsqu'une fonction se trouve definie dans un autre fichier, il est necessaire de la declarer. Pour cela, 
il suffit de donner sa declaration (le mot cle extern est egalement utilisable, mais facultatif dans ce 
cas) : 

int f actorielle (int ) ; 
/* 

factorielle est une fonction attendant comme parametre 

un entier et renvoyant une valeur entiere. 

Elle est definie dans un autre fichier. 
*/ 



Les fonctions inline doivent imperativement etre definies dans les fichiers ou elles sont utilisees, 
puisqu'en theorie, elles sont recopiees dans les fonctions qui les utilisent. Cela implique de placer 
leur definition dans les fichiers d'en-tete .h ou .hpp. Comme le code des fonctions inline est 
normalement inclus dans le code des fonctions qui les utilisent, les fichiers d'en-tete contenant du 
code inline peuvent etre compiles separement sans que ces fonctions ne soient definies plusieurs 
fois. Par consequent, l'editeur de liens ne generera pas d'erreur (alors qu'il 1'aurait fait si on avait 
place le code d'une fonction non inline dans un fichier d'en-tete inclus dans plusieurs fichiers 
sources . c ou . cpp). Certains programmeurs considerent qu'il n'est pas bon de placer des definitions 
de fonctions dans des fichiers d'en-tete, il placent done toutes leurs fonctions inline dans des fichiers 
portant 1' extension . inl. Ces fichiers sont ensuite inclus soit dans les fichiers d'en-tete . h, soit dans 
les fichiers . c ou . cpp qui utilisent les fonctions inline. 



6.5.4. Directives d'edition de liens 

Le langage C++ donne la possibilite d'appeler des fonctions et d'utiliser des variables qui proviennent 
d'un module ecrit dans un autre langage. Pour permettre cela, il dispose de directives permettant 
d'indiquer comment l'edition de liens doit etre faite. La syntaxe permettant de realiser cela utilise 
le mot cle extern, avec le nom du langage entre guillemets. Cette directive d'edition de liens doit 
preceder les declarations de variables et de donnees concernees. Si plusieurs variables ou fonctions 
utilisent la meme directive, elles peuvent etre regroupees dans un bloc delimite par des accolades, 
avec la directive d'edition de liens placee juste avant ce bloc. La syntaxe est done la suivante : 

extern "langage" [declaration | { 
declaration 
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}] 



Cependant, les seuls langages qu'une implementation doit obligatoirement supporter sont les langages 
« C » et « C++ ». Pour les autres langages, aucune norme n'est definie et les directives d' edition de 
liens sont dependantes de 1' implementation. 

Exemple 6-4. Declarations utilisables en C et en C++ 

tifdef cplusplus 

extern "C" 

{ 

#endif 

extern int EntierC; 

int FonctionC (void) ; 

#ifdef cplusplus 

} 
tendif 

Dans l'exemple precedent, la compilation conditionnelle est utilisee pour n'utiliser la directive 
d'edition de liens que si le code est compile en C++. Si c'est le cas, la variable EntierC et la 
fonction FonctionC sont declarees au compilateur C++ comme etant des objets provenant d'un 
module C. 
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Chapitre 7. Comment faire du code illisible ? 

II est facile, tres facile, de faire des programmes illisibles en C ou en C++. II existe meme un concours 
du code le plus obscur ! Cela dit, deux choses peuvent etre dites a ce propos : 



1. Ca n'accroit pas la vitesse du programme. Si Ton veut aller plus vite, il faut revoir l'algorithme 
ou changer de compilateur (inutile de faire de l'assembleur : les bons compilateurs se debrouillent 
mieux que les etre humains sur ce terrain. L'avantage de l'assembleur est que la, au moins, on est 
sur d' avoir un programme illisible.). 

2. Ca augmente les chances d' avoir des bogues. 



Si vous voulez malgre tout vous amuser, voici quelques conseils utiles : 



ecrivez des macros complexes qui font des effets de bords insoupconnes et qui modifient des 
variables globales ; 

abusez de l'operateur ternaire ? : et surtout de l'operateur virgule , . Utilisez les operateurs 
d' incrementation et de decrementation a outrance, en version prefixee et suffixee, tout 
specialement dans des expressions utilisant des pointeurs ; 

• placez ces operateurs dans les structures de controles. Notamment, utilisez l'operateur virgule pour 
faire des instructions composees dans les tests du while et dans tous les membres du for. II est 
souvent possible de mettre le corps du for dans les parentheses ; 

si necessaire, utiliser les expressions composees ( { et } ) dans les structures de controle ; 

choisissez des noms de variable et de fonction aleatoires (pensez a une phrase, et prenez les pre- 
mieres ou les deuxiemes lettres des mots au hasard) ; 

regroupez toutes les fonctions dans un meme fichier, par ordre de non-appariement ; 

inversement, dispersez les definitions des variables globales dans tout le programme, si possible 
dans des fichiers ou elles ne sont pas utilisees ; 

faites des fonctions a rallonge ; 

ne soignez pas l'apparence de votre programme (pas d' indentation ou, au contraire, trop 
d' indentations), regroupez plusieurs instructions sur une meme ligne ; 

rajoutez des parentheses la ou elles ne sont pas necessaires ; 

rajoutez des transtypages la ou ils ne sont pas necessaires ; 

ne commentez rien, ou mieux, donnez des commentaires sans rapport avec le code. 



Exemple 7-1. Programme parfaitement illisible 

/* Que fait ce programme ? */ 
#include <stdio.h> 
int main (void) 

( 
int zkmlpf , geikgh, wdxa j ; 

scanf ("%u", & zkmlpf) ; for (wdxa j=0, 

geikgh=0 ; 
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( (wdxa j+=++geikgh) , geikgh) <zkmlpf ; ) ; 
print f ( "%u" , wdxa j ) ; return 0; 



Vous l'aurez compris : il est plus simple de dire ici ce qu'il ne faut pas faire que de dire comment il 
faut faire. Je ne pretends pas imposer a quiconque une methodologie quelconque, car chacun est libre 
de programmer comme il l'entend. En effet, certaines conventions de codages sont aussi absurdes 
qu'inutiles et elles ont 1' inconvenient de ne plaire qu'a celui qui les a ecrites (et encore...)- C'est pour 
cette raison que je me suis contente de lister les sources potentielles d'illisibilite des programmes. 
Sachez done simplement que si vous utilisez une des techniques donnees dans ce paragraphe, vous 
devriez vous assurer que c'est reellement justifie et revoir votre code. Pour obtenir des programmes 
lisibles, il faut simplement que chacun y mettre un peu du sien, c'est aussi une marque de politesse 
envers les autres programmeurs. 
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La couche objet constitue sans doute la plus grande innovation du C++ par rapport au C. Le but 
de la programmation objet est de permettre une abstraction entre 1' implementation des modules et 
leur utilisation, apportant ainsi un plus grand confort dans la programmation. Elle s'integre done 
parfaitement dans le cadre de la modularite. Enfin, 1' encapsulation des donnees permet une meilleure 
protection et done une plus grande fiabilite des programmes. 



8.1. Generalites 



Theoriquement, il y a une nette distinction entre les donnees et les operations qui leur sont appli- 
quees. En tout cas, les donnees et le code ne se melangent pas dans la memoire de l'ordinateur, sauf 
cas tres particuliers (autoprogrammation, alias pour le chargement des programmes ou des overlays, 
debogueurs, virus). 

Cependant, 1' analyse des problemes a traiter se presente d'une maniere plus naturelle si Ton considere 
les donnees avec leurs proprietes. Les donnees constituent les variables, et les proprietes les operations 
qu'on peut leur appliquer. De ce point de vue, les donnees et le code sont logiquement inseparables, 
meme s'ils sont places en differents endroits de la memoire de l'ordinateur. 

Ces considerations conduisent a la notion d' objet. Un objet est un ensemble de donnees sur lesquelles 
des procedures peuvent etre appliquees. Ces procedures ou fonctions applicables aux donnees sont 
appelees methodes. La programmation d'un objet se fait done en indiquant les donnees de l'objet et 
en definissant les procedures qui peuvent lui etre appliquees. 

II se peut qu'il y ait plusieurs objets identiques, dont les donnees ont bien entendu des valeurs diffe- 
rentes, mais qui utilisent le meme jeu de methodes. On dit que ces differents objets appartiennent a 
la meme classe d' objets. Une classe constitue done une sorte de type, et les objets de cette classe en 
sont des instances. La classe definit done la structure des donnees, alors appelees champs ou variables 
d'instances, que les objets correspondants auront, ainsi que les methodes de l'objet. A chaque instan- 
tiation, une allocation de memoire est faite pour les donnees du nouvel objet cree. L'initialisation de 
l'objet nouvellement cree est faite par une methode speciale, le constructeur . Lorsque l'objet est de- 
truit, une autre methode est appelee : le destructeur . L'utilisateurpeut definir ses propres constructeurs 
et destructeurs d'objets si necessaire. 

Comme seules les valeurs des donnees des differents objets d'une classe different, les methodes sont 
mises en commun pour tous les objets d'une meme classe (e'est-a-dire que les methodes ne sont pas 
recopiees). Pour que les methodes appelees pour un objet sachent sur quelles donnees elles doivent 
travailler, un pointeur sur l'objet contenant ces donnees leur est passe en parametre. Ce mecanisme 
est completement transparent pour le programmeur en C++. 

Nous voyons done que non seulement la programmation orientee objet est plus logique, mais elle est 
egalement plus efficace (les methodes sont mises en commun, les donnees sont separees). 

Enfin, les donnees des objets peuvent etre protegees : e'est-a-dire que seules les methodes de l'objet 
peuvent y acceder. Ce n'est pas une obligation, mais cela accroit la fiabilite des programmes. Si une 
erreur se produit, seules les methodes de l'objet doivent etre verifiees. De plus, les methodes consti- 
tuent ainsi une interface entre les donnees de l'objet et l'utilisateur de l'objet (un autre programmeur). 
Cet utilisateur n'a done pas a savoir comment les donnees sont gerees dans l'objet, il ne doit utiliser 
que les methodes. Les avantages sont immediats : il ne risque pas de faire des erreurs de programma- 
tion en modifiant les donnees lui-meme, l'objet est reutilisable dans un autre programme parce qu'il a 
une interface standardised, et on peut modifier 1' implementation interne de l'objet sans avoir a refaire 
tout le programme, pourvu que les methodes gardent le meme nom, les memes parametres et la meme 
semantique. Cette notion de protection des donnees et de masquage de 1' implementation interne aux 
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utilisateurs de l'objet constitue ce que Ton appelle V encapsulation. Les avantages de {'encapsulation 
seront sou vent mis en valeur dans la suite au travers d'exemples. 

Nous allons entrer maintenant dans le vif du sujet. Cela permettra de comprendre ces generalites. 



8.2. Extension de la notion de type du C 

II faut avant tout savoir que la couche objet n'est pas un simple ajout au langage C, c'est une veritable 
extension. En effet, les notions qu'elle a apportees ont ete integrees au C a tel point que le typage 
des donnees de C a fusionne avec la notion de classe. Ainsi, les types predefinis char, int, double, etc. 
representent a present l'ensemble des proprietes des variables ayant ce type. Ces proprietes constituent 
la classe de ces variables, et elles sont accessibles par les operateurs. Par exemple, 1' addition est une 
operation pouvant porter sur des entiers (entre autres) qui renvoie un objet de la classe entier. Par 
consequent, les types de base se manipuleront exactement comme des objets. Du point de vue du 
C++, les utiliser revient deja a faire de la programmation orientee objet. 

De meme, le programmeur peut, a l'aide de la notion de classe d' objets, definir de nouveaux types. Ces 
types comprennent la structure des donnees representees par ces types et les operations qui peuvent 
leur etre appliquees. En fait, le C++ assimile completement les classes avec les types, et la definition 
d'un nouveau type se fait done en definissant la classe des variables de ce type. 



8.3. Declaration de classes en C++ 

Afin de permettre la definition des methodes qui peuvent etre appliquees aux structures des classes 
C++, la syntaxe des structures C a ete etendue (et simplified). II est a present possible de definir 
completement des methodes dans la definition de la structure. Cependant il est preferable de la reporter 
et de ne laisser que leur declaration dans la structure. En effet, cela accroit la lisibilite et permet de 
masquer 1' implementation de la classe a ses utilisateurs en ne leur montrant que sa declaration dans 
un fichier d'en-tete. lis ne peuvent done ni la voir, ni la modifier (en revanche, ils peuvent toujours 
voir la structure de donnees utilisee par son implementation). 

La syntaxe est la suivante : 

struct Norn 
{ 

[type champs; 

[type champs; 

[...]]] 

[methode; 
[methode; 
[...]]] 



ou Nom est le nom de la classe. Elle peut contenir divers champs de divers types. 

Les methodes peuvent etre des definitions de fonctions, ou seulement leurs declarations. Si on ne 
donne que leurs declarations, on devra les definir plus loin. Pour cela, il faudra specifier la classe a 
laquelle elles appartiennent avec la syntaxe suivante : 

type classe :: nom (parametres) 
{ 

/* Definition de la methode. */ 
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La syntaxe est done identique a la definition d'une fonction normale, a la difference pres que leur 
nom est precede du nom de la classe a laquelle elles appartiennent et de deux deux-points ( : :). Cet 
operateur : : est appele Y operateur de resolution de portee. II permet, d'une maniere generale, de 
specifier le bloc auquel l'objet qui le suit appartient. Ainsi, le fait de preceder le nom de la methode 
par le nom de la classe permet au compilateur de savoir de quelle classe cette methode fait partie. 
Rien n'interdit, en effet, d' avoir des methodes de meme signature, pourvu qu' elles soient dans des 
classes differentes. 

Exemple 8-1. Declaration de methodes de classe 

struct Entier 
{ 

int i; // Donnee membre de type entier. 

// Fonction definie a l'interieur de la classe : 

int lit_i (void) 

{ 

return i; 



// Fonction definie a l'exterieur de la classe : 
void ecrit_i(int valeur) ; 

}; 

void Entier :: ecrit_i (int valeur) 
{ 

i=valeur; 

return ; 
} 



Note : Si la liste des parametres de la definition de la fonction contient des initialisations sup- 
plementaires a celles qui ont ete specifiees dans la declaration de la fonction, les deux jeux 
d'initialisations sont fusionnees et utilisees dans le fichier ou la definition de la fonction est placee. 
Si les initialisations sont redondantes ou contradictoires, le compilateur genere une erreur. 



Note : L'operateur de resolution de portee permet aussi de specifier le bloc d'instructions d'un 
objet qui n'appartient a aucune classe. Pour cela, on ne mettra aucun nom avant l'operateur 
de resolution de portee. Ainsi, pour acceder a une fonction globale a l'interieur d'une classe 
contenant une fonction de meme signature, on fera preceder le nom de la fonction globale de cet 
operateur. 

Exemple 8-2. Operateur de resolution de portee 

int valeur (void) // Fonction globale. 

{ 

return 0; 
} 

struct A 
{ 

int i; 

void fixe (int a) 
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{ 

i=a; 
return; 



int valeur (void) // Meme signature que la fonction globale . 
< 

return i; 



int global_valeur (void) 

< 

return ::valeur(); // Accede a la fonction globale. 



De meme, I'operateur de resolution de portee permettra d'acceder a une variable globale 
lorsqu'une autre variable homonyme aura ete definie dans le bloc en cours. Par exemple : 



int i=l; // Premiere variable de portee globale 

int main (void) 
{ 

if (testO) 
{ 

int i=3; // Variable homonyme de portee locale. 

int j=2*::i; // j vaut a present 2, et non pas 6. 
/* Suite . . . */ 



/* Suite . . . */ 
return 0; 



Les champs d'une classe peuvent etre accedes comme des variables normales dans les methodes de 
cette classe. 

Exemple 8-3. Utilisation des champs d'une classe dans une de ses methodes 

struct client 
{ 

char Nom[21], Prenom[21]; // Definit le client. 

unsigned int Date_Entree; // Date d' entree du client 



// dans la base de donnees . 



int Solde; 

bool dans_le_rouge (void) 
{ 

return (Solde<0) ; 



bool bon_client (void) // Le bon client est 

// un ancien client. 
{ 

return (Date_Entree<l 993) ; // Date limite : 1993. 
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} 
}; 

Dans cet exemple, le client est defini par certaines donnees. Plusieurs methodes sont definies dans la 
classe meme. 

L'instanciation d'un objet se fait comme celle d'une simple variable : 

classe objet; 

Par exemple, si on a une base de donnees devant contenir 100 clients, on peut faire : 

client clientele [100] ; /* Instancie 100 clients. */ 



On remarquera qu'il est a present inutile d'utiliser le mot cle struct pour declarer une variable, 
contrairement a ce que la syntaxe du C exigeait. 

L'acces aux methodes de la classe se fait comme pour acceder aux champs des structures. On donne 
le nom de 1' objet et le nom du champ ou de la methode, separes par un point. Par exemple : 

/* Relance de tous les mauvais payeurs . */ 

int i; 

for (1=0; i<100; ++i) 

if (clientele [i] . dans_le_rouge () ) relance (clientele [i] ) ; 



Lorsque les fonctions membres d'une classe sont definies dans la declaration de cette classe, le com- 
pilateur les implemente en inline (a moins qu'elles ne soient recursives ou qu'il existe un pointeur 
sur elles). 

Si les methodes ne sont pas definies dans la classe, la declaration de la classe sera mise dans un 
fichier d'en-tete, et la definition des methodes sera reportee dans un fichier C++, qui sera compile 
et lie aux autres fichiers utilisant la classe client. Bien entendu, il est toujours possible de declarer 
les fonctions membres comme etant des fonctions inline meme lorsqu'elles sont definies en dehors 
de la declaration de la classe. Pour cela, il faut utiliser le mot cle inline, et placer le code de ces 
fonctions dans le fichier d'en-tete ou dans un fichier . inl. 

Sans fonctions inline, notre exemple devient : 

Fichier client. h : 

struct client 
{ 

char Nom[21], Prenom[21]; 

unsigned int Date_Entree; 

int Solde; 

bool dans_le_rouge (void) ; 
bool bon_client (void) ; 

}; 



/* 

Attention a ne pas oublier le ; a la fin de la classe dans un 
fichier .h ! L'erreur apparaitrait dans tous les fichiers ayant 
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une ligne #include "client. h" , parce que la compilation a lieu 

apres l'appel au preprocesseur . 

*/ 



Fichier client. cc : 

/* Inclut la declaration de la classe : */ 
#include "client. h" 

/* Definit les methodes de la classe : */ 

bool client :: dans_le_rouge (void) 
{ 

return (Solde<0) ; 



bool client : :bon_client (void) 
{ 

return (Date_Entree<l 993 ) ; 



8.4. Encapsulation des donnees 



Les divers champs d'une structure sont accessibles en n'importe quel endroit du programme. Une 
operation telle que celle-ci est done faisable : 

clientele [0] .Solde = 25000; 



Le solde d'un client peut done etre modifie sans passer par une methode dont ce serait le but. Elle 
pourrait par exemple verifier que Ton n'affecte pas un solde superieur au solde maximal autorise par 
le programme (la borne superieure des valeurs des entiers signes). Par exemple, si les entiers sont 
codes sur 16 bits, cette borne maximum est 32767. Un programme qui ferait : 

clientele [0] .Solde = 32800; 

obtiendrait done un solde de -12 (valeur en nombre signe du nombre non signe 32800), alors qu'il 
espererait obtenir un solde positif ! 

II est possible d'empecher 1' acces des champs ou de certaines methodes a toute fonction autre que 
celles de la classe. Cette operation s'appelle l'encapsulation. Pour la realiser, il faut utiliser les mots 
cles suivants : 

• public : les acces sont libres ; 

• private : les acces sont autorises dans les fonctions de la classe seulement ; 

• protected : les acces sont autorises dans les fonctions de la classe et de ses descendantes (voir 
la section suivante) seulement. Le mot cle protected n'est utilise que dans le cadre de l'heritage 
des classes. La section suivante detaillera ce point. 
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Pour changer les droits d'acces des champs et des methodes d'une classe, il faut faire preceder ceux- 
ci du mot cle indiquant les droits d'acces suivi de deux points (' : '). Par exemple, pour proteger les 
donnees relatives au client, on changera simplement la declaration de la classe en : 

struct client 

{ 

private: // Donnees privees : 

char Nom[21], Prenom[21]; 

unsigned int Date_Entree; 

int Solde; 

// II n'y a pas de methode privee . 

public: // Les donnees et les methodes publiques : 

// II n'y a pas de donnee publique. 
bool dans_le_rouge (void) ; 
bool bon_client (void) 

}; 



Outre la verification de la validite des operations, 1' encapsulation a comme interet fondamental de 
definir une interface stable pour la classe au niveau des methodes et donnees membres publiques et 
protegees. L' implementation de cette interface, realisee en prive, peut etre modifiee a loisir sans pour 
autant perturber les utilisateurs de cette classe, tant que cette interface n'est pas elle-meme modifiee. 

Par defaut, les classes construites avec struct ont tous leurs membres publics. II est possible de 
declarer une classe dont tous les elements sont par defaut prives. Pour cela, il suffit d'utiliser le mot 
cle class a la place du mot cle struct. 

Exemple 8-4. Utilisation du mot cle class 

class client 
{ 

// private est a present inutile. 

char Nom[21], Prenom[21]; 
unsigned int Date_Entree; 
int Solde; 

public: // Les donnees et les methodes publiques. 

bool dans_le_rouge (void) ; 
bool bon_client (void) ; 



Enfin, il existe un dernier type de classe, que je me contenterai de mentionner : les classes union. Elles 
se declarent comme les classes struct et class, mais avec le mot cle union. Les donnees sont, 
comme pour les unions du C, situees toutes au meme emplacement, ce qui fait qu'ecrire dans l'une 
d'entre elle provoque la destruction des autres. Les unions sont tres souvent utilisees en programma- 
tion systeme, lorsqu'un polymorphisme physique des donnees est necessaire (c'est-a-dire lorsqu'elles 
doivent etre interpreters de differentes facons selon le contexte). 

Note : Les classes de type union ne peuvent pas avoir de methodes virtuelles et de membres 
statiques. Elles ne peuvent pas avoir de classes de base, ni servir de classe de base. Enfin, les 
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unions ne peuvent pas contenir des references, ni des objets dont la classe a un constructeur non 
trivial, un constructeur de copie non trivial ou un destructeur non trivial. Pour toutes ces notions, 
voir la suite du chapitre. 

Les classes definies au sein d'une autre classe sont considerees comme faisant partie de leur 
classe hote, et ont done le droit d'acceder aux donnees membres private et protected de celle- 
ci. Remarquez que cette regie est assez recente dans la norme du langage, et que la plupart des 
compilateurs refuseront ces acces. II faudra done declarer amies de la classe hote les classes 
qui sont definies au sein de celle-ci. La maniere de proceder sera decrite dans la Section 8.7.2. 



8.5. Heritage 



L'heritage permet de donner a une classe toutes les caracteristiques d'une ou de plusieurs autres 
classes. Les classes dont elle herite sont appelees classes meres, classes de base ou classes antece- 
dentes. La classe elle-meme est appelee classe fille, classe derivee ou classe descendante. 

Les proprietes heritees sont les champs et les methodes des classes de base. 

Pour faire un heritage en C++, il faut faire suivre le nom de la classe fille par la liste des classes meres 
dans la declaration avec les restrictions d' acces aux donnees, chaque element etant separe des autres 
par une virgule. La syntaxe (donnee pour class, identique pour struct) est la suivante : 

class Classe_merel 

/* Contenu de la classe mere 1. */ 



class Classe_mere2 

/* Contenu de la classe mere 2. */ 
;] 

• • .] 

class Classe_fille : public I protected I private Classe_merel 
, public I protected | private Classe_mere2 [...]] 



/* Definition de la classe fille. */ 



}; 



Dans cette syntaxe, Classe_f ille herite de la Classe_merel, et des Classe_mere2, etc. si elles 
sont presentes. 

La signification des mots cles private, protected et public dans l'heritage est recapitulee dans 
le tableau suivant : 



Tableau 8-1. Droits d'acces sur les membres herites 





mot cle utilise pour l'heritage 


Acces aux donnees 


public 


protected 


private 


mot cle utilise 


public 


public 


protected 


private 


pour les champs 


protected 


protected 


protected 


private 
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mot cle utilise pour I'heritage 


Acces aux donnees 


public 


protected 


private 


et les methodes 


private 


interdit 


interdit 


interdit 



Ainsi, les donnees publiques d'une classe mere deviennent soit publiques, soit protegees, soit privees 
selon que la classe fille herite en public, protege ou en prive. Les donnees privees de la classe mere 
sont toujours inaccessibles, et les donnees protegees deviennent soit protegees, soit privees. 

II est possible d'omettre les mots cles public, protected et private dans la syntaxe de I'heritage. 
Le compilateur utilise un type d'heritage par defaut dans ce cas. Les classes de type struct utilisent 
I'heritage public par defaut et les classes de type class utilisent le mot cle private par defaut. 

Exemple 8-5. Heritage public, prive et protege 

class Emplacement 



protected: 

int x, y; 



// Donnees ne pouvant etre accedees 
// que par les classes filles. 



public : 

void Change (int, int); // Methode toujours accessible. 

}; 

void Emplacement :: Change (int i, int j) 
{ 

x = i; 

Y = j; 
return; 



class Point : public Emplacement 

{ 

protected: 

unsigned int couleur; // Donnee accessible 

// aux classes filles. 

public : 

void SetColor (unsigned int); 

}; 

void Point :: SetColor (unsigned int NewColor) 
{ 

couleur = NewColor; // Definit la couleur. 

return; 
} 

Si une classe Cercle doit heriter de deux classes meres, par exemple Emplacement et Forme, sa de- 
claration aura la forme suivante : 



class Cercle : public Emplacement, public Forme 
{ 



Definition de la classe Cercle. Cette classe herite 



99 



Chapitre 8. C+ + : la couche objet 



des donnees publiques et protegees des classes Emplacement 
et Forme. 
*/ 

}; 



II est possible de redefinir les fonctions et les donnees des classes de base dans une classe derivee. 
Par exemple, si une classe B derive de la classe A, et que toutes deux contiennent une donnee d, les 
instances de la classe B utiliseront la donnee d de la classe B et les instances de la classe A utiliseront 
la donnee d de la classe A. Cependant, les objets de classe B contiendront egalement un sous-objet, 
lui-meme instance de la classe de base A. Par consequent, ils contiendront la donnee d de la classe A, 
mais cette derniere sera cachee par la donnee d de la classe la plus derivee, a savoir la classe B. 

Ce mecanisme est general : quand une classe derivee redefinit un membre d'une classe de base, ce 
membre est cache et on ne peut plus acceder directement qu'au membre redefini (celui de la classe 
derivee). Cependant, il est possible d'acceder aux donnees cachees si Ton connait leur classe, pour 
cela, il faut nommer le membre completement a l'aide de l'operateur de resolution de portee (: :). 
Le nom complet d'un membre est constitue du nom de sa classe suivi de l'operateur de resolution de 
portee, suivis du nom du membre : 

classe: :membre 



Exemple 8-6. Operateur de resolution de portee et membre de classes de base 

struct Base 
{ 

int i; 
}; 

struct Derivee : public Base 
{ 

int i; 

int LitBase (void) ; 

}; 

int Derivee :: LitBase (void) 
{ 

return Base::i; // Renvoie la valeur i de la classe de base. 
} 

int main (void) 
{ 

Derivee D; 

D.i=l; // Accede a l'entier i de la classe Derivee. 

D.Base::i=2; // Accede a l'entier i de la classe Base. 

return 0; 
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8.6. Classes virtuelles 



Supposons a present qu'une classe D herite de deux classes meres, les classes B et C. Supposons 
egalement que ces deux classes heritent d'une classe mere commune appelee classe A. On a l'arbre 
« genealogique » suivant : 







On sait que B et C heritent des donnees et des methodes publiques et protegees de A. De meme, D 
herite des donnees de B et C, et par leur intermediate des donnees de A. II se pose done le probleme 
suivant : quelles sont les donnees que Ton doit utiliser quand on reference les champs de A ? Celles 
de B ou celles de C ? On peut acceder aux deux sous-objets de classe A en specifiant le chemin a 
suivre dans l'arbre genealogique a l'aide de l'operateur de resolution de portee. Cependant, cela n'est 
ni pratique ni efficace, et en general, on s' attend a ce qu'une seule copie de A apparaisse dans D. 

Le probleme est resolu en declarant virtuelle la classe de base commune dans la specification de 
l'heritage pour les classes filles. Les donnees de la classe de base ne seront alors plus dupliquees. 
Pour declarer une classe mere comme une classe virtuelle, il faut faire preceder son nom du mot cle 
virtual dans l'heritage des classes filles. 

Exemple 8-7. Classes virtuelles 

class A 



protected: 

int Donnee; 

}; 



// La donnee de la classe de base. 



// Heritage de la classe A, virtuelle : 

class B : virtual public A 

{ 

protected: 

int Valeur_B; // Autre donnee que "Donnee" (heritee) 



// A est toujours virtuelle 
class C : virtual public A 
{ 
protected: 
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int valeur_C; // Autre donnee 

// ("Donnee" est acquise par heritage) . 
}; 

class D : public B, public C // Ici, Donnee n'est pas duplique. 
{ 

/* Definition de la classe D. */ 

}; 

Note : Normalement, I'heritage est realise par le compilateur par aggregation de la structure de 
donnees des classes de base dans la structure de donnees de la classe derivee. Pour les classes 
virtuelles, ce n'est en general pas le cas, puisque le compilateur doit assurer I'unicite des donnees 
heritees de ces classes, meme en cas d'heritage multiple. Par consequent, certaines restrictions 
d'usage s'appliquent sur les classes virtuelles. 

Premierement, il est impossible de transtyper directement un pointeur sur un objet d'une classe 
de base virtuelle en un pointeur sur un objet d'une de ses classes derivees. II faut imperativement 
utiliser I'operateur de transtypage dynamique dynamic_cast. Cet operateur sera decrit dans le 
Chapitre 10. 

Deuxiemement, chaque classe derivee directement ou indirectement d'une classe virtuelle doit 
en appeler le constructeur explicitement dans son constructeur si celui-ci prend des parametres. 
En effet, elle ne peut pas se tier au fait qu'une autre de ses classes de base, elle-meme derivee 
de la classe de base virtuelle, appelle un constructeur specifique, car il est possible que plusieurs 
classes de base cherchent a initialiser differemment chacune un objet commun herite de la classe 
virtuelle. Pour reprendre I'exemple donne ci-dessus, si les classes B et C appellaient toutes les 
deux un constructeur non trivial de la classe virtuelle A, et que la classe D appellait elle-meme 
les constructeurs de B et C, le sous-objet herite de A serait construit plusieurs fois. Pour eviter 
cela, le compilateur ignore purement et simplement les appels au constructeur des classes de 
bases virtuelles dans les classes de base derivees. II faut done systematiquement le specifier, a 
chaque niveau de la hierarchie de classe. La notion de constructeur sera vue dans la Section 8.8 



8.7. Fonctions et classes amies 

II est parfois necessaire d' avoir des fonctions qui ont un acces illimite aux champs d'une classe. En 
general, l'emploi de telles fonctions traduit un manque d'analyse dans la hierarchie des classes, mais 
pas toujours. Elles restent done necessaires malgre tout. 

De telles fonctions sont appelees des fonctions amies. Pour qu'une fonction soit amie d'une classe, il 
faut qu'elle soit declaree dans la classe avec le mot cle friend. 

II est egalement possible de faire une classe amie d'une autre classe, mais dans ce cas, cette classe 
devrait peut-etre etre une classe fille. L'utilisation des classes amies peut traduire un defaut de concep- 
tion. 

8.7.1. Fonctions amies 

Les fonctions amies se declarent en faisant preceder la declaration classique de la fonction du mot cle 
friend a l'interieur de la declaration de la classe cible. Les fonctions amies ne sont pas des methodes 
de la classe cependant (cela n'aurait pas de sens puisque les methodes ont deja acces aux membres de 
la classe). 
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Exemple 8-8. Fonctions amies 

class A 
{ 

int a; // Une donnee privee. 

friend void ecrit_a(int i); // Une fonction amie . 

}; 

A essai; 

void ecrit_a(int i) 
{ 

essai. a=i; // Initialise a. 

return; 
} 

II est possible de declarer amie une fonction d'une autre classe, en precisant son nom complet a l'aide 
de l'operateur de resolution de portee. 



8.7.2. Classes amies 

Pour rendre toutes les methodes d'une classe amies d'une autre classe, il suffit de declarer la classe 
complete comme etant amie. Pour cela, il faut encore une fois utiliser le mot cle friend avant la 
declaration de la classe, a l'interieur de la classe cible. Cette fois encore, la classe amie declaree ne 
sera pas une sous-classe de la classe cible, mais bien une classe de portee globale. 

Note : Le fait, pour une classe, d'appartenir a une autre classe lui donne le droit d'acceder aux 
membres de sa classe hote. II n'est done pas necessaire de declarer amies d'une classe les 
classes definies au sein de celle-ci. Remarquez que cette regie a ete recemment modifiee dans 
la norme C++, et que la plupart des compilateurs refuseront aux classes incluses d'acceder aux 
membres non publics de leur conteneur. 



Exemple 8-9. Classe amie 

#include <stdio.h> 

class Hote 
{ 

friend class Amie; // Toutes les methodes de Amie sont amies. 

int i; // Donnee privee de la classe Hote. 



public : 






Hote 


(voi 


-d) 


{ 


1=0; 




i 


return ; 


}; 






Hote h; 






class Am 


ie 
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public : 

void print_hote (void) 



print f ( "%d\n" , h.i); // Accede a la donnee privee de h. 
return ; 



int main (void) 
{ 

Amie a; 

a.print_hote ( ) ; 

return 0; 
} 

On remarquera plusieurs choses importantes. Premierement, l'amitie n'estpas transitive. Cela signifie 
que les amis des amis ne sont pas des amis. Une classe A amie d'une classe B, elle-meme amie d'une 
classe C, n'est pas amie de la classe C par defaut. II faut la declarer amie explicitement si on desire 
qu'elle le soit. Deuxiemement, les amis ne sont pas herites. Ainsi, si une classe A est amie d'une 
classe B et que la classe C est une classe fille de la classe B, alors A n'est pas amie de la classe C par 
defaut. Encore une fois, il faut la declarer amie explicitement. Ces remarques s'appliquent egalement 
aux fonctions amies (une fonction amie d'une classe A amie d'une classe B n'est pas amie de la classe 
B, ni des classes derivees de A). 



8.8. Constructeurs et destructeurs 

Le constructeur et le destructeur sont deux methodes particulieres qui sont appelees respectivement 
a la creation et a la destruction d'un objet. Toute classe a un constructeur et un destructeur par defaut, 
fournis par le compilateur. Ces constructeurs et destructeurs appellent les constructeurs par defaut et 
les destructeurs des classes de base et des donnees membres de la classe, mais en dehors de cela, ils 
ne font absolument rien. II est done souvent necessaire de les redefinir afin de gerer certaines actions 
qui doivent avoir lieu lors de la creation d'un objet et de leur destruction. Par exemple, si l'objet doit 
contenir des variables allouees dynamiquement, il faut leur reserver de la memoire a la creation de 
l'objet ou au moins mettre les pointeurs correspondants a null. A la destruction de l'objet, il convient 
de restituer la memoire allouee, s'il en a ete alloue. On peut trouver bien d'autres situations ou une 
phase d' initialisation et une phase de terminaison sont necessaires. 

Des qu'un constructeur ou un destructeur a ete defini par l'utilisateur, le compilateur ne definit 
plus automatiquement le constructeur ou le destructeur par defaut correspondant. En particulier, si 
l'utilisateur definit un constructeur prenant des parametres, il ne sera plus possible de construire un 
objet simplement, sans fournir les parametres a ce constructeur, a moins bien entendu de definir ega- 
lement un constructeur qui ne prenne pas de parametres. 

8.8.1. Definition des constructeurs et des destructeurs 

Le constructeur se definit comme une methode normale. Cependant, pour que le compilateur puisse 
la reconnaitre en tant que constructeur, les deux conditions suivantes doivent etre verifiees : 

• elle doit porter le meme nom que la classe ; 

• elle ne doit avoir aucun type, pas meme le type void. 
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Le destructeur doit egalement respecter ces regies. Pour le differencier du constructeur, son nom sera 
toujours precede du signe tilde ('-'). 

Un constructeur est appele automatiquement lors de 1'instanciation de l'objet. Le destructeur est ap- 
pele automatiquement lors de sa destruction. Cette destruction a lieu lors de la sortie du bloc de 
portee courante pour les objets de classe de stockage auto. Pour les objets alloues dynamiquement, 
le constructeur et le destructeur sont appeles automatiquement par les expressions qui utilisent les 
operateurs new, new [ ] , delete et delete [ ] . C'est pour cela qu'il est recommande de les utiliser 
a la place des fonctions malloc et free du C pour creer dynamiquement des objets. De plus, il ne 
faut pas utiliser delete ou delete [ ] sur des pointeurs de type void, car il n'existe pas d'objets de 
type void. Le compilateur ne peut done pas determiner quel est le destructeur a appeler avec ce type 
de pointeur. 

Le constructeur est appele apres l'allocation de la memoire de l'objet et le destructeur est appele avant 
la liberation de cette memoire. La gestion de l'allocation dynamique de memoire avec les classes est 
ainsi simplifiee. Dans le cas des tableaux, l'ordre de construction est celui des adresses croissantes, et 
l'ordre de destruction est celui des adresses decroissantes. C'est dans cet ordre que les constructeurs 
et destructeurs de chaque element du tableau sont appeles. 

Les constructeurs pourront avoir des parametres. lis peuvent done etre surcharges, mais pas les des- 
tructeurs. Cela est du a fait qu'en general on connait le contexte dans lequel un objet est cree, mais 
qu'on ne peut pas connaitre le contexte dans lequel il est detruit : il ne peut done y avoir qu'un seul 
destructeur. Les constructeurs qui ne prennent pas de parametre ou dont tous les parametres ont une 
valeur par defaut, remplacent automatiquement les constructeurs par defaut definis par le compilateur 
lorsqu'il n'y a aucun constructeur dans les classes. Cela signifie que ce sont ces constructeurs qui 
seront appeles automatiquement par les constructeurs par defaut des classes derivees. 

Exemple 8-10. Constructeurs et destructeurs 

class chaine // Implemente une chalne de caracteres. 

{ 

char * s; // Le pointeur sur la chaine de caracteres. 

public : 

chaine (void) ; // Le constructeur par defaut. 

chaine (unsigned int); // Le constructeur. II n'a pas de type. 

-chaine (void) ; // Le destructeur. 

}; 

chaine : : chaine (void) 
{ 

s=NULL; // La chaine est initialisee avec 

return ; // le pointeur nul . 



chaine :: chaine (unsigned int Taille) 
{ 

s = new char [Taille + 1 ] ; // Alloue de la memoire pour la chaine. 

s[0]='\0'; // Initialise la chaine a "". 

return; 
} 

chaine : : -chaine (void) 
{ 

if (s!=NULL) delete[] s; // Restitue la memoire utilisee si 
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II necessaire. 
return; 



Pour passer les parametres au constructeur, on donne la liste des parametres entre parentheses juste 
apres le nom de 1' objet lors de son instanciation : 



chaine si; // Instancie une chaine de caracteres 

// non initialisee. 
chaine s2(200); // Instancie une chaine de caracteres 

// de 200 caracteres. 



Les constructeurs devront parfois effectuer des taches plus compliquees que celles donnees dans cet 
exemple. En general, ils peuvent faire toutes les operations faisables dans une methode normale, 
sauf utiliser les donnees non initialisees bien entendu. En particulier, les donnees des sous-objets 
d'un objet ne sont pas initialisees tant que les constructeurs des classes de base ne sont pas appeles. 
C'est pour cela qu'il faut toujours appeler les constructeurs des classes de base avant d'executer le 
constructeur de la classe en cours d' instanciation. Si les constructeurs des classes de base ne sont 
pas appeles explicitement, le compilateur appellera, par defaut, les constructeurs des classes meres 
qui ne prennent pas de parametre ou dont tous les parametres ont une valeur par defaut (et, si aucun 
constructeur n'est defini dans les classe meres, il appellera les constructeurs par defaut de ces classes). 

Comment appeler les constructeurs et les destructeurs des classes meres lors de 1' instanciation et de la 
destruction d'une classe derivee ? Le compilateur ne peut en effet pas savoir quel constructeur il faut 
appeler parmi les differents constructeurs surcharges potentiellement presents... Pour appeler un autre 
constructeur d'une classe de base que le constructeur ne prenant pas de parametre, il faut specifier 
explicitement ce constructeur avec ses parametres apres le nom du constructeur de la classe fille, en 
les separant de deux points (' : '). 

En revanche, il est inutile de preciser le destructeur a appeler, puisque celui-ci est unique. Le program- 
meur ne doit done pas appeler lui-meme les destructeurs des classes meres, le langage s'en charge. 

Exemple 8-11. Appel du constructeur des classes de base 

/* Declaration de la classe mere. */ 

class Mere 
{ 

int m_i; 
public : 

Mere (int) ; 

-Mere (void) ; 
}; 

/* Definition du constructeur de la classe mere. */ 

Mere : :Mere (int i) 
{ 

m_i = i ; 

printf ( "Execution du constructeur de la classe mere.\n"); 

return; 
} 

/* Definition du destructeur de la classe mere. */ 
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Mere : : -Mere (void) 
{ 

print f ( "Execution du destructeur de la classe mere.Xn"); 
return; 



/* Declaration de la classe fille. */ 

class Fille : public Mere 

{ 

public : 

Fille (void) ; 

-Fille (void) ; 

}; 

/* Definition du constructeur de la classe fille 
avec appel du constructeur de la classe mere. */ 

Fille: :Fille (void) : Mere(2) 
{ 

printf ( "Execution du constructeur de la classe fille. \n"); 

return; 
} 

/* Definition du destructeur de la classe fille 

avec appel automatique du destructeur de la classe mere. */ 

Fille: : -Fille (void) 
{ 

printf ( "Execution du destructeur de la classe fille.\n"); 

return; 
} 

Lors de l'instanciation d'un objet de la classe fille, le programme affichera dans l'ordre les messages 
suivants : 

Execution du constructeur de la classe mere. 
Execution du constructeur de la classe fille. 



et lors de la destruction de 1' objet : 

Execution du destructeur de la classe fille. 
Execution du destructeur de la classe mere. 



Si Ton n'avait pas precise que le constructeur a appeler pour la classe Mere etait le constructeur 
prenant un entier en parametre, le compilateur aurait essaye d' appeler le constructeur par defaut de 
cette classe. Or, ce constructeur n'etant plus genere automatiquement par le compilateur (a cause de 
la definition d'un constructeur prenant un parametre), il y aurait eu une erreur de compilation. 

II est possible d' appeler plusieurs constructeurs si la classe derive de plusieurs classes de base. Pour 
cela, il suffit de lister les constructeurs un a un, en separant leurs appels par des virgules. On notera 
cependant que l'ordre dans lequel les constructeurs sont appeles n'est pas forcement l'ordre dans 
lequel ils sont listes dans la definition du constructeur de la classe fille. En effet, le C++ appelle 
toujours les constructeurs dans l'ordre d' apparition de leurs classes dans la liste des classes de base 
de la classe derivee. 
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Note : Afin d'eviter I'utilisation des donnees non initialisees de I'objet le plus derive dans une 
hierarchie pendant la construction de ses sous-objets par I'intermediaire des fonctions virtuelles, 
le mecanisme des fonctions virtuelles est desactive dans les constructeurs (voyez la Section 
8.13 pour plus de details sur les fonctions virtuelles). Ce probleme survient parce que pendant 
I'execution des constructeurs des classes de base, I'objet de la classe en cours d'instanciation 
n'a pas encore ete initialise, et malgre cela, une fonction virtuelle aurait pu utiliser une donnee de 
cet objet. 

Une fonction virtuelle peut done toujours etre appelee dans un constructeur, mais la fonction 
effectivement appelee est celle de la classe du sous-objet en cours de construction : pas celle de 
la classe de I'objet complet. Ainsi, si une classe A herite d'une classe B et qu'elles ont toutes les 
deux une fonction virtuelle f , I'appel de f dans le constructeur de B utilisera la fonction t de B, 
pas celle de A (meme si I'objet que Ton instancie est de classe A). 



La syntaxe utilisee pour appeler les constructeurs des classes de base peut egalement etre utilisee 
pour initialiser les donnees membres de la classe. En particulier, cette syntaxe est obligatoire pour 
les donnees membres constantes et pour les references, car le C++ ne permet pas F affectation d'une 
valeur a des variables de ce type. Encore une fois, l'ordre d'appel des constructeurs des donnees 
membres ainsi initialisees n'est pas forcement l'ordre dans lequel ils sont listes dans le constructeur 
de la classe. En effet, le C++ utilise cette fois l'ordre de declaration de chaque donnee membre. 

Exemple 8-12. Initialisation de donnees membres constantes 

class tableau 
{ 

const int m_iTailleMax; 

const int *m_pDonnees; 
public : 

tableau (int iTailleMax); 

-tableau ( ) ; 
}; 

tableau :: tableau (int iTailleMax) : 

m_iTailleMax (iTailleMax) // Initialise la donnee membre constante. 
{ 

// Allocation d' un tableau de m_iTailleMax entrees : 

m_pDonnees = new int [m_iTailleMax] ; 
} 

tableau: :~tableau() 
{ 

// Destruction des donnees : 

delete [] m_pDonnees; 
} 



Note : Les constructeurs des classes de base virtuelles prenant des parametres doivent etre 
appeles par chaque classe qui en derive, que cette derivation soit directe ou indirecte. En effet, les 
classes de base virtuelles subissent un traitement particulier qui assure I'unicite de leurs donnees 
dans toutes leurs classes derivees. Les classes derivees ne peuvent done pas se reposer sur 
leurs classes de base pour appeler le constructeur des classes virtuelles, car il peut y avoir 
plusieurs classes de bases qui derivent d'une meme classe virtuelle, et cela supposerait que 
le constructeur de cette derniere classe serait appele plusieurs fois, eventuellement avec des 
valeurs de parametres differentes. Chaque classe doit done prendre en charge la construction 
des sous-objets des classes de base virtuelles dont il herite dans ce cas. 
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8.8.2. Constructeurs de copie 

II faudra parfois creer un constructeur de copie. Le but de ce type de constructeur est d'initialiser 
un objet lors de son instanciation a partir d'un autre objet. Toute classe dispose d'un constructeur 
de copie par defaut genere automatiquement par le compilateur, dont le seul but est de recopier les 
champs de l'objet a recopier un a un dans les champs de l'objet a instancier. Toutefois, ce constructeur 
par defaut ne suffira pas toujours, et le programmeur devra parfois en fournir un explicitement. 

Ce sera notamment le cas lorsque certaines donnees des objets auront ete allouees dynamiquement. 
Une copie brutale des champs d'un objet dans un autre ne ferait que recopier les pointeurs, pas les 
donnees pointees. Ainsi, la modification de ces donnees pour un objet entrainerait la modification des 
donnees de l'autre objet, ce qui ne serait sans doute pas l'effet desire. 

La definition des constructeurs de copie se fait comme celle des constructeurs normaux. Le nom doit 
etre celui de la classe, et il ne doit y avoir aucun type. Dans la liste des parametres cependant, il devra 
toujours y avoir une reference sur l'objet a copier. 

Pour la classe chaine definie ci-dessus, il faut un constructeur de copie. Celui-ci peut etre declare de 
la facon suivante : 

chaine (const chaine SSource); 

ou Source est l'objet a copier. 

Si Ton rajoute la donnee membre Taille dans la declaration de la classe, la definition de ce 
constructeur peut etre : 

chaine :: chaine (const chaine SSource) 
{ 

int i = 0; // Compteur de caracteres. 

Taille = Source. Taille; 

s = new char [Taille + 1]; // Effectue 1' allocation . 

strcpy(s, Source. s); // Recopie la chaine de caracteres source. 

return; 



Le constructeur de copie est appele dans toute instanciation avec initialisation, comme celles qui 
suivent : 

chaine s2 (si ) ; 
chaine s2 = si; 



Dans les deux exemples, c'est le constructeur de copie qui est appele. En particulier, a la deuxieme 
ligne, le constructeur normal n'est pas appele et aucune affectation entre objets n'a lieu. 

Note : Le fait de definir un constructeur de copie pour une classe signifie generalement que le 
constructeur de copie, le destructeur et I'operateur d'affectation fournis par defaut par le compi- 
lateur ne conviennent pas pour cette classe. Par consequent, ces methodes devront systema- 
tiquement etre redefinies toutes les trois des que I'une d'entre elle le sera. Cette regie, que Ton 
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appelle la regie des trois, vous permettra d'eviter des bogues facilement. Vous trouverez de plus 
amples details sur la maniere de redefinir I'operateur d'affectation dans la Section 8.1 1 .3. 



8.8.3. Utilisation des constructeurs dans les transtypages 

Les constructeurs sont utilises dans les conversions de type dans lesquelles le type cible est celui 
de la classe du constructeur. Ces conversions peuvent etre soit implicites (dans une expression), soit 
explicite (a l'aide d'un transtypage). Par defaut, les conversions implicites sont legales, pourvu qu'il 
existe un constructeur dont le premier parametre a le meme type que 1' objet source. Par exemple, la 
classe Entier suivante : 
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dispose d'un constructeur de transtypage pour les entiers. Les expressions suivantes : 

int j = 2; 

Entier el, e2=j; 

el = j; 

sont done legales, la valeur entiere situee a la droite de l'expression etant convertie implicitement en 
un objet du type de la classe Entier. 

Si, pour une raison quelconque, ce comportement n'est pas souhaitable, on peut forcer le compilateur 
a n' accepter que les conversions explicites (a l'aide de transtypage). Pour cela, il suffit de placer le mot 
cle explicit avant la declaration du constructeur. Par exemple, le constructeur de la classe chaine 
vue ci-dessus prenant un entier en parametre risque d'etre utilise dans des conversions implicites. 
Or ce constructeur ne permet pas de construire une chaine de caracteres a partir d'un entier, et ne 
doit done pas etre utilise dans les operations de transtypage. Ce constructeur doit done etre declare 
explicit : 

class chaine 
{ 

s i z e_t T a i 1 1 e ; 

char * s; 

public : 

chaine (void) ; 

// Ce constructeur permet de preciser la taille de la chaine 
// a sa creation : 

explicit chaine (unsigned int); 
-chaine (void) ; 

}; 



no 
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Avec cette declaration, F expression suivante : 

int j = 2; 

chaine s = j ; 

n'est plus valide, alors qu'elle l'etait lorsque le constructeur n'etait pas declare explicit. 

Note : On prendra garde au fait que le mot cle explicit n'empeche I'utilisation du constructeur 
dans les operations de transtypage que dans les conversions implicites. Si le transtypage est ex- 
plicitement demande, le constructeur sera malgre tout utilise. Ainsi, le code suivant sera accepte : 



int j=2; 

chaine s = (chaine) j; 

Bien entendu, cela n'a pas beaucoup de signification et ne devrait jamais etre effectue. 



8.9. Pointeur this 



Nous allons a present voir comment les fonctions membres, qui appartiennent a la classe, peuvent 
acceder aux donnees d'un objet, qui est une instance de cette classe. Cela est indispensable pour bien 
comprendre les paragraphes suivants. 

A chaque appel d'une fonction membre, le compilateur passe implicitement un pointeur sur les don- 
nees de l'objet en parametre. Ce parametre est le premier parametre de la fonction. Ce mecanisme est 
completement invisible au programmeur, et nous ne nous attarderons pas dessus. 

En revanche, il faut savoir que le pointeur sur l'objet est accessible a l'interieur de la fonction membre. 
II porte le nom « this ». Par consequent, *this represente l'objet lui-meme. Nous verrons une 
utilisation de this dans le paragraphe suivant (surcharge des operateurs). 

this est un pointeur constant, c'est-a-dire qu'on ne peut pas le modifier (il est done impossible de 
faire des operations arithmetiques dessus). Cela est tout a fait normal, puisque le faire reviendrait a 
sortir de l'objet en cours (celui pour lequel la methode en cours d'execution travaille). 

II est possible de transformer ce pointeur constant en un pointeur constant sur des donnees constantes 
pour chaque fonction membre. Le pointeur ne peut toujours pas etre modifie, et les donnees de l'objet 
ne peuvent pas etre modifiees non plus. L'objet est done considere par la fonction membre concernee 
comme un objet constant. Cela revient a dire que la fonction membre s'interdit la modification des 
donnees de l'objet. On parvient a ce resultat en ajoutant le mot cle const a la suite de l'en-tete de la 
fonction membre. Par exemple : 

class Entier 
{ 

int i; 

public : 

int lit (void) const; 
}; 

int Entier :: lit (void) const 



111 



Chapitre 8. C+ + : la couche objet 



return i; 
} 



Dans la fonction membre lit, il est impossible de modifier l'objet. On ne peut done acceder qu'en 
lecture seule a i. Nous verrons une application de cette possibility dans la Section 8.15. 

II est a noter qu'une methode qui n'est pas declaree comme etant const modifie a priori les donnees 
de l'objet sur lequel elle travaille. Done, si elle est appelee sur un objet declare const, une erreur 
de compilation se produit. Ce comportement est normal. On devra done toujours declarer const une 
methode qui ne modifie pas reellement l'objet, afin de laisser a l'utilisateur le choix de declarer const 
ou non les objets de sa classe. 

Note : Le mot cle const n'intervient pas dans la signature des fonctions en general lorsqu'il 
s'applique aux parametres (tout parametre declare const perd sa qualification dans la signature). 
En revanche, il intervient dans la signature d'une fonction membre quand il s'applique a cette 
fonction (ou, plus precisement, a l'objet pointe par this). II est done possible de declarer deux 
fonctions membres acceptant les memes parametres, dont une seule est const. Lors de I'appel, 
la determination de la fonction a utiliser dependra de la nature de l'objet sur lequel elle doit 
s'appliquer. Si l'objet est const, la methode appelee sera celle qui est const. 



8.10. Donnees et fonctions membres statiques 

Nous allons voir dans ce paragraphe l'emploi du mot cle static dans les classes. Ce mot cle inter- 
vient pour caracteriser les donnees membres statiques des classes, les fonctions membres statiques 
des classes, et les donnees statiques des fonctions membres. 

8.10.1. Donnees membres statiques 

Une classe peut contenir des donnees membres statiques. Ces donnees sont soit des donnees membres 
propres a la classe, soit des donnees locales statiques des fonctions membres de la classe. Dans tous 
les cas, elles appartiennent a la classe, et non pas aux objets de cette classe. Elles sont done communes 
a tous ces objets. 

II est impossible d'initialiser les donnees d'une classe dans le constructeur de la classe, car le construe - 
teur n' initialise que les donnees des nouveaux objets. Les donnees statiques ne sont pas specifiques 
a un objet particulier et ne peuvent done pas etre initialisees dans le constructeur. En fait, leur initia- 
lisation doit se faire lors de leur definition, en dehors de la declaration de la classe. Pour preciser la 
classe a laquelle les donnees ainsi definies appartiennent, on devra utiliser l'operateur de resolution 
deportee (: :). 

Exemple 8-13. Donnee membre statique 

class test 
{ 

static int i; // Declaration dans la classe. 



int test::i=3; // Initialisation en dehors de la classe. 
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La variable test : : i sera partagee par tous les objets de classe test, et sa valeur initiale est 3. 

Note : La definition des donnees membres statiques suit les memes regies que la definition des 
variables globales. Autrement dit, elles se comportent comme des variables declarees externes. 
Elles sont done accessibles dans tous les fichiers du programme (pourvu, bien entendu, qu'elles 
soient declarees en zone publique dans la classe). De meme, elles ne doivent etre definies qu'une 
seule fois dans tout le programme. II ne faut done pas les definir dans un fichier d'en-tete qui peut 
etre inclus plusieurs fois dans des fichiers sources, meme si Ton protege ce fichier d'en-tete 
contre les inclusions multiples. 



Les variables statiques des fonctions membres doivent etre initialisees a l'interieur des fonctions 
membres. Elles appartiennent egalement a la classe, et non pas aux objets. De plus, leur portee est 
reduite a celle du bloc dans lequel elles ont ete declarees. Ainsi, le code suivant : 

tinclude <stdio.h> 

class test 

{ 

public : 

int n (void) ; 
}; 

int test : :n (void) 
{ 

static int compte=0; 

return compte++; 
} 

int main (void) 
{ 

test objetl, objet2; 

print f("%d ", objetl. n ()) ; // Affiche 

printf ("%d\n", objet2.n()); // Affiche 1 

return 0; 
} 

affichera et 1, parce que la variable statique compte est la meme pour les deux objets. 



8.10.2. Fonctions membres statiques 

Les classes peuvent egalement contenir des fonctions membres statiques. Cela peut surprendre a pre- 
miere vue, puisque les fonctions membres appartiennent deja a la classe, e'est-a-dire a tous les objets. 
En fait, cela signifie que ces fonctions membres ne recevront pas le pointeur sur l'objet this, comme 
e'est le cas pour les autres fonctions membres. Par consequent, elles ne pourront acceder qu'aux 
donnees statiques de l'objet. 

Exemple 8-14. Fonction membre statique 

class Entier 
{ 

int i; 

static int j ; 
public : 
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static int get_value (void) ; 
}; 

int Entier::j=0; 

int Entier : : get_value (void) 



j=l; // Legal. 

return i; // ERREUR ! get_value ne peut pas acceder a i. 



} 



La fonction get_value de l'exemple ci-dessus ne peut pas acceder a la donnee membre non statique 
i, parce qu'elle ne travaille sur aucun objet. Son champ d'action est uniquement la classe Entier. En 
revanche, elle peut modifier la variable statique j, puisque celle-ci appartient a la classe Entier et non 
aux objets de cette classe. 

L'appel des fonctions membre statiques se fait exactement comme celui des fonctions membres non 
statiques, en specifiant l'identificateur d'un des objets de la classe et le nom de la fonction membre, 
separes par un point. Cependant, comme les fonctions membres ne travaillent pas sur les objets des 
classes mais plutot sur les classes elles-memes, la presence de l'objet lors de l'appel est facultatif. On 
peut done se contenter d'appeler une fonction statique en qualifiant son nom du nom de la classe a 
laquelle elle appartient a l'aide de l'operateur de resolution de portee. 

Exemple 8-15. Appel de fonction membre statique 

class Entier 
{ 

static int i; 
public : 

static int get_value (void) ; 
}; 

int Entier: :i=3; 

int Entier :: get_value (void) 
{ 

return i; 



int main (void) 
{ 

// Appelle la fonction statique get_value : 

int resultat=Entier : : get_value ( ) ; 

return 0; 
} 

Les fonctions membres statiques sont souvent utilisees afin de regrouper un certain nombre de fonc- 
tionnalites en rapport avec leur classe. Ainsi, elles sont facilement localisable et les risques de confiits 
de noms entre deux fonctions membres homonymes sont reduits. Nous verrons egalement dans le 
Chapitre 1 1 comment eviter les confiits de noms globaux dans le cadre des espaces de nommage. 
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8.1 1 . Surcharge des operateurs 

On a vu precedemment que les operateurs ne se differencient des fonctions que syntaxiquement, pas 
logiquement. D'ailleurs, le compilateur traite un appel a un operateur comme un appel a une fonction. 
Le C++ permet done de surcharger les operateurs pour les classes definies par l'utilisateur, en utilisant 
une syntaxe particuliere calquee sur la syntaxe utilisee pour definir des fonctions membres normales. 
En fait, il est meme possible de surcharger les operateurs du langage pour les classes de l'utilisateur 
en dehors de la definition de ces classes. Le C++ dispose done de deux methodes differentes pour 
surcharger les operateurs. 

Les seuls operateurs qui ne peuvent pas etre surcharges sont les suivants : 



1 ; 

sizeof 

typeid 

static_cast 

dynamic_cast 

const_cast 

reinterpret_cast 

Tous les autres operateurs sont surchargeables. Leur surcharge ne pose generalement pas de probleme 
et peut etre realisee soit dans la classe des objets sur lesquels ils s'appliquent, soit a l'exterieur de 
cette classe. Cependant, un certain nombre d'entre eux demandent des explications complementaires, 
que Ton donnera a la fin de cette section. 

Note : On prendra garde aux problemes de performances lors de la surcharge des operateurs. 
Si la facilite d'ecriture des expressions utilisant des classes est grandement simplifies grace a la 
possibility de surcharger les operateurs pour ces classes, les performances du programme peu- 
vent en etre gravement affectees. En effet, I'utilisation inconsideree des operateurs peut conduire 
a un grand nombre de copies des objets, copies que Ton pourrait eviter en ecrivant le programme 
classiquement. Par exemple, la plupart des operateurs renvoient un objet du type de la classe sur 
laquelle ils travaillent. Ces objets sont souvent crees localement dans la fonction de I'operateur 
(e'est-a-dire qu'ils sont de portee auto). Par consequent, ces objets sont temporaires et sont 
detruits a la sortie de la fonction de I'operateur. Cela impose done au compilateur d'en faire une 
copie dans la valeur de retour de la fonction avant d'en sortir. Cette copie sera elle-meme detruite 
par le compilateur une fois qu'elle aura ete utilisee par I'instruction qui a appele la fonction. Si 
le resultat doit etre affecte a un objet de I'appelant, une deuxieme copie inutile est realisee par 
rapport au cas ou I'operateur aurait travaille directement dans la variable resultat. Si les bons 
compilateurs sont capables d'eviter ces copies, cela reste I'exception et il vaut mieux etre averti 
a I'avance plutot que de devoir reecrire tout son programme a posteriori pour des problemes de 
performances. 



Nous allons a present voir dans les sections suivantes les deux syntaxes permettant de surcharger 
les operateurs pour les types de l'utilisateur, ainsi que les regies specifiques a certains operateurs 
particuliers. 

8.11.1. Surcharge des operateurs internes 

Une premiere methode pour surcharger les operateurs consiste a les considerer comme des methodes 
normales de la classe sur laquelle ils s'appliquent. Le nom de ces methodes est donne par le mot 
cle operator, suivi de I'operateur a surcharger. Le type de la fonction de I'operateur est le type du 
resultat donne par 1'operation, et les parametres, donnes entre parentheses, sont les operandes. Les 
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operateurs de ce type sont appeles operateurs internes, parce qu'ils sont declares a l'interieur de la 
classe. 

Void la syntaxe : 

type operatorOp (parametres) 
l'ecriture 

A Op B 

se traduisant par : 

A. operatorOp (B) 



Avec cette syntaxe, le premier operande est toujours l'objet auquel cette fonction s'applique. Cette 
maniere de surcharger les operateurs est done particulierement bien adaptee pour les operateurs qui 
modifient l'objet sur lequel ils travaillent, comme par exemple les operateurs =, +=, ++, etc. Les 
parametres de la fonction operateur sont alors le deuxieme operande et les suivants. 

Les operateurs definis en interne devront souvent renvoyer l'objet sur lequel ils travaillent (ce n'est 
pas une necessite cependant). Cela est faisable grace au pointeur this. 

Par exemple, la classe suivante implemente les nombres complexes avec quelques-unes de leurs ope- 
rations de base. 

Exemple 8-16. Surcharge des operateurs internes 

class complexe 
{ 

double m_x, m_y; // Les parties reelles et imaginaires. 
public : 

// Constructeurs et operateur de copie : 

complexe (double x=0, double y=0); 

complexe (const complexe &); 

complexe &operator= (const complexe &); 

// Fonctions permettant de lire les parties reelles 
// et imaginaires : 
double re (void) const; 
double im(void) const; 

// Les operateurs de base: 

complexe &operator+= (const complexe &) 

complexe &operator-= (const complexe &) 

complexe &operator*= (const complexe S) 

complexe &operator/= (const complexe &) 
}; 

complexe :: complexe (double x, double y) 
{ 

m_x = x ; 

m_y = y; 

return ; 



complexe :: complexe (const complexe Ssource) 
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{ 

m_x = source. m_x; 

m_y = source. m_y; 

return ; 
} 

complexe Scomplexe :: operator= (const complexe Ssource) 
{ 

m_x = source. m_x; 

m_y = source. m_y; 

return *this; 
} 

double complexe :: re ( ) const 
{ 

return m_x; 



double complexe :: im ( ) const 
{ 

return m_y; 
} 

complexe Scomplexe :: operator+= (const complexe &c) 
{ 

m_x += c.m_x; 

m_y += c.m_y; 

return *this; 
} 

complexe Scomplexe :: operator-= (const complexe &c) 
{ 

m_x -= c.m_x; 

m_y -= c.m_y; 

return *this; 
} 

complexe Scomplexe :: operator*= (const complexe &c) 
{ 

double temp = m_x*c.m_x -m_y*c.m_y; 

m_y = m_x * c . m_y + m_y * c . m_x ; 

m_x = temp; 

return *this; 
} 

complexe Scomplexe :: operator/= (const complexe &c) 
{ 

double norm = c.m_x*c.m_x + c . m_y*c .m_y; 

double temp = (m_x*c.m_x + m_y*c.m_y) / norm; 

m_y = (-m_x*c.m_y + m_y*c.m_x) / norm; 

m_x = temp; 

return *this; 
} 

Note : La bibliotheque standard C++ fournit une classe traitant les nombres complexes de 
maniere complete, la classe complex. Cette classe n'est done donnee ici qu'a titre d'exemple et 
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ne devra evidemment pas etre utilisee. La definition des nombres complexes et de leur 
principales proprietes sera donnee dans la Section 14.3.1, ou laclasse complex seradecrite. 



Les operateurs d' affectation fournissent un exemple d' utilisation du pointeur this. Ces operateurs 
renvoient en effet systematiquement l'objet sur lequel ils travaillent, afin de permettre des affectations 
multiples. Les operateurs de ce type devront done tous se terminer par : 

return *this; 



8.11.2. Surcharge des operateurs externes 

Une deuxieme possibilite nous est offerte par le langage pour surcharger les operateurs. La definition 
de l'operateur ne se fait plus dans la classe qui 1'utilise, mais en dehors de celle-ci, par surcharge d'un 
operateur de l'espace de nommage global. II s'agit done d'operateurs externes cette fois. 

La surcharge des operateurs externes se fait done exactement comme on surcharge les fonctions nor- 
males. Dans ce cas, tous les operandes de l'operateur devront etre passes en parametres : il n'y aura 
pas de parametre implicite (le pointeur this n'est pas passe en parametre). 

La syntaxe est la suivante : 

type operatorOp (operandes) 

oil operandes est la liste complete des operandes. 

L'avantage de cette syntaxe est que l'operateur est reellement symetrique, contrairement a ce qui 
se passe pour les operateurs definis a l'interieur de la classe. Ainsi, si l'utilisation de cet operateur 
necessite un transtypage sur l'un des operandes, il n'est pas necessaire que cet operande soit obliga- 
toirement le deuxieme. Done si la classe dispose de constructeurs permettant de convertir un type de 
donnee en son prope type, ce type de donnee peut etre utilise avec tous les operateurs de la classe. 

Par exemple, les operateurs d' addition, de soustraction, de multiplication et de division de la classe 
complexe peuvent etre implemented comme dans V exemple suivant. 

Exemple 8-17. Surcharge d'operateurs externes 

class complexe 

{ 

friend complexe operatort (const complexe &, const complexe &) 

friend complexe operator- (const complexe &, const complexe &) 

friend complexe operator* (const complexe S, const complexe &) 

friend complexe operator/ (const complexe &, const complexe &) 

double m_x, m_y; // Les parties reelles et imaginaires. 
public : 

// Constructeurs et operateur de copie : 
complexe (double x=0, double y=0); 
complexe (const complexe S); 
complexe &operator= (const complexe &); 

// Fonctions permettant de lire les parties reelles 
// et imaginaires : 
double re (void) const; 
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double im(void) const; 

// Les operateurs de base: 

complexe &operator+= (const complexe &) 

complexe &operator-= (const complexe &) 

complexe &operator*= (const complexe &) 

complexe &operator/= (const complexe &) 
}; 

// Les operateurs de base ont ete eludes ici 



complexe operatort (const complexe Scl, const complexe &c2) 
{ 

complexe result = cl; 

return result += c2; 



complexe operator- (const complexe &cl, const complexe &c2) 
{ 

complexe result = cl; 

return result -= c2; 



complexe operator* (const complexe &cl, const complexe &c2) 
{ 

complexe result = cl; 

return result *= c2; 
} 

complexe operator/ (const complexe Scl, const complexe &c2) 
{ 

complexe result = cl; 

return result /= c2; 
} 

Avec ces definitions, il est parfaitement possible d'effectuer la multiplication d'un objet de type com- 
plexe avec une valeur de type double. En effet, cette valeur sera automatiquement convertie en com- 
plexe grace au constructeur de la classe complexe, qui sera utilise ici comme constructeur de transty- 
page. Une fois cette conversion effectuee, l'operateur adequat est applique. 

On constatera que les operateurs externes doivent etre declares comme etant des fonctions amies de la 
classe sur laquelle ils travaillent, faute de quoi ils ne pourraient pas manipuler les donnees membres 
de leurs operandes. 

Note : Certains compilateurs peuvent supprimer la creation des variables temporaires lorsque 
celles-ci sont utilisees en tant que valeur de retour des fonctions. Cela permet d'ameliorer grande- 
ment I'efficacite des programmes, en supprimant toutes les copies d'objets inutiles. Cependant 
ces compilateurs sont relativement rares et peuvent exiger une syntaxe particuliere pour effectuer 
cette optimisation. Generalement, les compilateurs C++ actuels suppriment la creation de vari- 
able temporaire dans les retours de fonctions si la valeur de retour est construite dans I'instruction 
return elle-meme. Par exemple, l'operateur d'addition peut etre optimise ainsi : 

complexe operator+ (const complexe &cl, const complexe &c2) 
{ 

return complexe (cl .m_x + c2.m_x, cl.m_y + c2.m_y); 
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Cette ecriture n'est cependant pas toujours utilisable, et I'optimisation n'est pas garantie. 



La syntaxe des operateurs externes permet egalement d'implementer les operateurs pour lesquels le 
type de la valeur de retour est celui de 1' operande de gauche et que le type de cet operande n'est pas 
une classe definie par 1'utilisateur (par exemple si c'est un type predefini). En effet, on ne peut pas 
definir l'operateur a l'interieur de la classe du premier operande dans ce cas, puisque cette classe est 
deja definie. De meme, cette syntaxe peut etre utile dans le cas de l'ecriture d'operateurs optimises 
pour certains types de donnees, pour lesquels les operations realisees par l'operateur sont plus simples 
que celles qui auraient ete effectuees apres transtypage. 

Par exemple, si Ton veut optimiser la multiplication a gauche par un scalaire pour la classe complexe, 
on devra proceder comme suit : 

complexe operator* (double k, const complexe &c) 
{ 

complexe result (c.re () *k, c . im ( ) *k) ; 

return result; 



ce qui permettra d'ecrire des expressions du type : 

complexe cl, c2; 
double r; 

cl = r*c2; 



La premiere syntaxe n'aurait permis d'ecrire un tel operateur que pour la multiplication a droite par 
un double. En effet, pour ecrire un operateur interne permettant de realiser cette optimisation, il aurait 
fallu surcharger l'operateur de multiplication de la classe double pour lui faire accepter un objet de 
type complexe en second operande... 



8.11.3. Operateurs d'affectation 

Nous avons deja vu un exemple d'operateur d'affectation avec la classe complexe ci-dessus. Cet 
operateur etait tres simple, mais ce n'est generalement pas toujours le cas, et 1' implementation des 
operateurs d'affectation peut parfois soulever quelques problemes. 

Premierement, comme nous l'avons dit dans la Section 8.8.2, le fait de definir un operateur 
d'affectation signale sou vent que la classe n'a pas une structure simple et que, par consequent, le 
constructeur de copie et le destructeur fournis par defaut par le compilateur ne suffisent pas. II faut 
done veiller a respecter la regie des trois, qui stipule que si l'une de ces methodes est redefinie, il faut 
que les trois le soient. Par exemple, si vous ne redefinissez pas le constructeur de copie, les ecritures 
telles que : 

classe object = source; 

ne fonctionneront pas correctement. En effet, c'est le constructeur de copie qui est appele ici, et 
non l'operateur d'affectation comme on pourrait le penser a premiere vue. De meme, les traitements 
particuliers effectues lors de la copie ou de l'initialisation d'un objet devront etre effectues en ordre 
inverse dans le destructeur de l'objet. Les traitements de destruction consistent generalement a liberer 
la memoire et toutes les ressources allouees dynamiquement. 
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Lorsque Ton ecrit un operateur d' affectation, on a generalement a reproduire, a peu de choses pres, le 
meme code que celui qui se trouve dans le constructeur de copie. II arrive meme parfois que l'on doive 
liberer les ressources existantes avant de faire 1' affectation, et done le code de l'operateur d' affectation 
ressemble souvent a la concatenation du code du destructeur et du code du constructeur de copie. Bien 
entendu, cette duplication de code est genante et peu elegante. Une solution simple est d'implementer 
une fonction de duplication et une fonction de liberation des donnees. Ces deux fonctions, par exemple 
reset et clone, pourront etre utilisees dans le destructeur, le constructeur de copie et l'operateur 
d' affectation. Le programme devient ainsi plus beaucoup plus simple. II ne faut generalement pas 
utiliser l'operateur d' affectation dans le constructeur de copie, car cela peut poser des problemes 
complexes a resoudre. Par exemple, il faut s'assurer que l'operateur de copie ne cherche pas a utiliser 
des donnees membres non initialisees lors de son appel. 

Un autre probleme important est celui de l'autoaffectation. Non seulement affecter un objet a lui- 
meme est inutile et consommateur de ressources, mais en plus cela peut etre dangereux. En effet, 
1' affectation risque de detruire les donnees membres de 1' objet avant meme qu'elles ne soient copiees, 
ce qui provoquerait en fin de compte simplement la destruction de l'objet ! Une solution simple 
consiste ici a ajouter un test sur l'objet source en debut d'operateur, comme dans l'exemple suivant : 

classe Sclasse :: operator= (const classe Ssource) 
{ 

if (Ssource != this) 

{ 

// Traitement de copie des donnees : 



return *this; 
} 



Enfin, la copie des donnees peut lancer une exception et laisser l'objet sur lequel l'affectation se fait 
dans un etat indetermine. La solution la plus simple dans ce cas est encore de construire une copie 
de l'objet source en local, puis d'echanger le contenu des donnees de l'objet avec cette copie. Ainsi, 
si la copie echoue pour une raison ou une autre, l'objet source n'est pas modifie et reste dans un etat 
stable. Le pseudo-code permettant de realiser ceci est le suivant : 

classe Sclasse :: operator= (const classe Ssource) 
{ 

// Construit une copie temporaire de la source : 

class Temp (source) ; 

// Echange le contenu de cette copie avec l'objet courant : 

swap (Temp, *this); 

// Renvoie l'objet courant (modifie) et detruit les donnees 

// de la variable temporaire (contenant les anciennes donnees) : 

return *this; 
} 



Note : Le probleme de I'etat des objets n'est pas specifique a l'operateur d'affectation, mais a 
toutes les methodes qui modifient l'objet, done, en pratique, a toutes les methodes non const. 
L'ecriture de classes sures au niveau de la gestion des erreurs est done relativement difficile. 

Vous trouverez de plus amples informations sur le mecanisme des exceptions en C++ dans le 
Chapitre 9. 
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8.11.4. Operateurs de transtypage 

Nous avons vu dans la Section 8.8.3 que les constructeurs peuvent etre utilises pour convertir des 
objets du type de leur parametre vers le type de leur classe. Ces conversions peuvent avoir lieu de 
maniere implicite ou non, selon que le mot cle explicit est applique au constructeur en question. 

Cependant, il n'est pas toujours faisable d'ecrire un tel constructeur. Par exemple, la classe cible 
peut parfaitement etre une des classes de la bibliotheque standard, dont on ne doit evidemment pas 
modifier les fichiers source, ou meme un des types de base du langage, pour lequel il n'y a pas de 
definition. Heureusement, les conversions peuvent malgre tout etre realisees dans ce cas, simplement 
en surchargeant les operateurs de transtypage. 

Prenons F exemple de la classe chaine, qui permet de faire des chaines de caracteres dynamiques (de 
longueur variable). II est possible de les convertir en chaine C classiques (c'est-a-dire en tableau de 
caracteres) si l'operateur (char const *) a ete surcharge : 

chaine :: operator char const * (void) const; 



On constatera que cet operateur n'attend aucun parametre, puisqu'il s'applique a l'objet qui l'appelle, 
mais surtout il n'a pas de type. En effet, puisque c'est un operateur de transtypage, son type est 
necessairement celui qui lui correspond (dans le cas present, char const *). 

Note : Si un constructeur de transtypage est egalement defini dans la classe du type cible de la 
conversion, il peut exister deux moyens de realiser le transtypage. Dans ce cas, le compilateur 
choisira toujours le constructeur de transtypage de la classe cible a la place de l'operateur de 
transtypage, sauf s'il est declare explicit. Ce mot cle peut done etre utilise partout ou Ton veut 
eviter que le compilateur n'utilise le constructeur de transtypage. Cependant, cette technique ne 
fonctionne qu'avec les conversions implicites realisees par le compilateur. Si I'utilisateur effectue 
un transtypage explicite, ce sera a nouveau le constructeur qui sera appele. 

De plus, les conversions realisees par I'intermediaire d'un constructeur sont souvent plus perfor- 
mantes que celles realisees par I'intermediaire d'un operateur de transtypage, en raison du fait 
que Ton evite ainsi la copie de la variable temporaire dans le retour de l'operateur de transtypage. 
On evitera done de definir les operateurs de transtypage autant que faire se peut, et on ecrira de 
preference des constructeurs dans les classes des types cibles des conversions realisees. 



8.11.5. Operateurs de comparaison 

Les operateurs de comparaison sont tres simples a surcharges La seule chose essentielle a retenir est 
qu'ils renvoient une valeur booleenne. Ainsi, pour la classe chaine, on peut declarer les operateurs 
d'egalite et d'inferiorite (dans 1'ordre lexicographique par exemple) de deux chaines de caracteres 
comme suit : 

bool chaine :: operator== (const chaine &) const; 
bool chaine :: operator< (const chaine &) const; 
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8.11.6. Operateurs d'incrementation et de decrementation 

Les operateurs d'incrementation et de decrementation sont tous les deux doubles, c'est-a-dire que la 
meme notation represente deux operateurs en realite. En effet, ils n'ont pas la meme signification, 
selon qu'ils sont places avant ou apres leur operande. Le probleme est que comme ces operateurs ne 
prennent pas de parametres (ils ne travaillent que sur 1' objet), il est impossible de les differencier par 
surcharge. La solution qui a ete adoptee est de les differencier en donnant un parametre fictif de type 
int a l'un d'entre eux. Ainsi, les operateurs ++ et — ne prennent pas de parametre lorsqu'il s'agit des 
operateurs prefixes, et ont un argument fictif (que Ton ne doit pas utiliser) lorsqu'ils sont suffixes. Les 
versions prefixees des operateurs doivent renvoyer une reference sur F objet lui-meme, les versions 
suffixees en revanche peuvent se contenter de renvoyer la valeur de F objet. 

Exemple 8-18. Operateurs d'incrementation et de decrementation 

class Entier 
{ 

int i; 

public : 

Entier (int j ) 
{ 

return; 



Entier operator + t (int ) // Operateur suffixe : 
{ // retourne la valeur et incremente 

Entier tmp(i); // la variable. 

+ + i; 

return tmp; 
} 

Entier &operator++ (void) // Operateur prefixe : incremente 
{ // la variable et la retourne. 

+ + i; 

return *this; 



Note : Les operateurs suffixes creant des objets temporaires, ils peuvent nuire gravement aux 
performances des programmes qui les utilisent de maniere inconsideree. Par consequent, on ne 
les utilisera que lorsque cela est reellement necessaire. En particulier, on evitera d'utiliser ces 
operateurs dans toutes les operations d'incrementation des boucles d'iteration. 



8.11.7. Operateur fonctionnel 

L operateur d'appel de fonctions ( ) peut egalement etre surcharge. Cet operateur permet de realiser 
des objets qui se comportent comme des fonctions (ce que Fon appelle des foncteurs). La bibliotheque 
standard C++ en fait un usage intensif, comme nous pourrons le constater dans la deuxieme partie de 
ce document. 

L'operateur fonctionnel est egalement tres utile en raison de son n-arite (*, /, etc. sont des operateurs 
binaires car ils ont deux operandes, ? : est un operateur ternaire car il a trois operandes, ( ) est n-aire 
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car il peut avoir n operandes). II est done utilise couramment pour les classes de gestion de matrices 
de nombres, afin d'autoriser l'ecriture « matrice (i, j, k) ». 

Exemple 8-19. Implementation d'une classe matrice 

class matrice 
{ 

typedef double *ligne; 

ligne *lignes; 

unsigned short int n; // Nombre de lignes (ler parametre) . 

unsigned short int m; // Nombre de colonnes (2eme parametre) . 

public : 

matrice (unsigned short int nl, unsigned short int nc); 

matrice (const matrice Ssource); 

-matrice (void) ; 

matrice &operator= (const matrice &ml); 

double Soperator () (unsigned short int i, unsigned short int j); 

double operator)) (unsigned short int i, unsigned short int j) const; 

}; 

// Le constructeur : 

matrice : :matrice (unsigned short int nl, unsigned short int nc) 

{ 

n = nl; 

m = nc; 

lignes = new ligne [n]; 

for (unsigned short int i=0; i<n; ++i) 
lignes [i] = new double [ra] ; 

return; 
} 

// Le constructeur de copie : 

matrice : :matrice (const matrice Ssource) 

{ 

m = source. m; 

n = source. n; 

lignes = new ligne [n]; // Alloue. 

for (unsigned short int i=0; i<n; ++i) 

{ 

lignes [i] = new double [m] ; 

for (unsigned short int j=0; j<m; ++j) // Copie. 
lignes[i] [j] = source . lignes [i] [j]; 
} 
return; 



// Le destructeur : 
matrice : : -matrice (void) 
{ 

for (unsigned short int i=0; i<n; ++i) 
delete [] lignes [i]; 

delete [] lignes; 

return; 



// L'operateur d' affectation : 
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matrice Smatrice :: operator= (const matrice Ssource) 
{ 

if (Ssource != this) 
{ 

if (source. n!=n | | source. m!=m) // Verifie les dimensions. 
{ 

for (unsigned short int i=0; i<n; ++i) 

delete [] lignes[i]; 
delete[] lignes; // Detruit . . . 

m = source. m; 
n = source. n; 

lignes = new ligne [n] ; // et realloue. 
for (i = 0; i<n; + + i) lignes [i] = new double [m] ; 
} 

for (unsigned short int i=0; i<n; ++i) // Copie. 
for (unsigned short int j=0; j<m; ++j) 
lignes [i] [j] = source . lignes [i] [j]; 
} 
return *this; 



// Operateurs d'acces : 

double Smatrice :: operator ( ) (unsigned short int i, 

unsigned short int j) 
{ 

return lignes[i] [j]; 
} 

double matrice :: operator ( ) (unsigned short int i, 

unsigned short int j) const 
{ 

return lignes [i] [j]; 
} 

Ainsi, on pourra effectuer la declaration d'une matrice avec : 



matrice m (2 , 3 ) ; 

et acceder a ses elements simplement avec 

m(i, j) =6; 



On remarquera que Ton a defini deux operateurs fonctionnels dans l'exemple donne ci-dessus. Le 
premier renvoie une reference et permet de modifier la valeur d'un des elements de la matrice. Cet 
operateur ne peut bien entendu pas s'appliquer a une matrice constante, meme simplement pour lire 
un element. C'est done le deuxieme operateur qui sera utilise pour lire les elements des matrices 
constantes, car il renvoie une valeur et non plus une reference. Le choix de l'operateur a utiliser est 
determine par la presence du mot cle const, qui indique que seul cet operateur peut etre utilise pour 
une matrice constante. 

Note : Les operations de base sur les matrices (addition, soustraction, inversion, transposition, 
etc.) n'ont pas ete reportees ici par souci de clarte. La maniere de definir ces operateurs a ete 
presentee dans les sections precedentes. 
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8.11.8. Operateurs d'indirection et de dereferencement 

L'operateur de dereferencement * permet l'ecriture de classes dont les objets peuvent etre utilises dans 
des expressions manipulant des pointeurs. L'operateur d'indirection & quant a lui, permet de renvoyer 
une adresse autre que celle de l'objet sur lequel il s'applique. Enfin, l'operateur de dereferencement 
et de selection de membres de structures -> permet de realiser des classes qui encapsulent d'autres 
classes. 

Si les operateurs de dereferencement et d'indirection & et * peuvent renvoyer une valeur de type 
quelconque, ce n'est pas le cas de l'operateur de dereferencement et de selection de membre ->. Cet 
operateur doit necessairement renvoyer un type pour lequel il doit encore etre applicable. Ce type doit 
done soit surcharger l'operateur ->, soit etre un pointeur sur une structure, union ou classe. 

Exemple 8-20. Operateur de dereferencement et d'indirection 

// Cette classe est encapsulee par une autre classe : 
struct Encapsulee 



int i; 



// Donnee a acceder. 



}; 



Encapsulee o; // Objet a manipuler. 

// Cette classe est la classe encapsulante 

struct Encapsulante 

{ 

Encapsulee *operator-> (void) const 

return So; 

Encapsulee *operator& (void) const 
return So; 

Encapsulee Soperator* (void) const 
return o; 

}; 



// Exemple d' utilisation : 

void f ( int i ) 

{ 

Encapsulante e; 

e->i=2; // Enregistre 2 dans o.i. 

(*e) .i = 3; // Enregistre 3 dans o.i. 

Encapsulee *p = &e; 

p->i = 4; // Enregistre 4 dans o.i. 

return ; 
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8.11.9. Operateurs d'allocation dynamique de memoire 

Les operateurs les plus difficiles a ecrire sont sans doute les operateurs d'allocation dynamique de 
memoire. Ces operateurs prennent un nombre variable de parametres, parce qu'ils sont completement 
surchargeables (c'est a dire qu'il est possible de definir plusieurs surcharges de ces operateurs meme 
au sein d'une meme classe, s'ils sont dermis de maniere interne). II est done possible de definir 
plusieurs operateurs new ou new [ ] , et plusieurs operateurs delete ou delete [ ] . Cependant, les 
premiers parametres de ces operateurs doivent toujours etre la taille de la zone de la memoire a allouer 
dans le cas des operateurs new et new [ ] , et le pointeur sur la zone de la memoire a restituer dans le 
cas des operateurs delete et delete [ ] . 

La forme la plus simple de new ne prend qu'un parametre : le nombre d'octets a allouer, qui vaut 
toujours la taille de l'objet a construire. II doit renvoyer un pointeur du type void. L'operateur delete 
correspondant peut prendre, quant a lui, soit un, soit deux parametres. Comme on l'a deja dit, le 
premier parametre est toujours un pointeur du type void sur l'objet a detruire. Le deuxieme parametre, 
s'il existe, est du type size_t et contient la taille de l'objet a detruire. Les memes regies s'appliquent 
pour les operateurs new [ ] et delete [ ] , utilises pour les tableaux. 

Lorsque les operateurs delete et delete [ ] prennent deux parametres, le deuxieme parametre est 
la taille de la zone de la memoire a restituer. Cela signifie que le compilateur se charge de memoriser 
cette information. Pour les operateurs new et delete, cela ne cause pas de probleme, puisque la taille 
de cette zone est fixee par le type de l'objet. En revanche, pour les tableaux, la taille du tableau doit 
etre stockee avec le tableau. En general, le compilateur utilise un en-tete devant le tableau d'objets. 
C'est pour cela que la taille a allouer passee a new [ ] , qui est la meme que la taille a desallouer passee 
en parametre a delete [ ] , n'est pas egale a la taille d'un objet multipliee par le nombre d'objets du 
tableau. Le compilateur demande un peu plus de memoire, pour memoriser la taille du tableau. On 
ne peut done pas, dans ce cas, faire d' hypotheses quant a la structure que le compilateur donnera a la 
memoire allouee pour stocker le tableau. 

En revanche, si delete [ ] ne prend en parametre que le pointeur sur le tableau, la memorisation de la 
taille du tableau est a la charge du programmeur. Dans ce cas, le compilateur donne a new [ ] la valeur 
exacte de la taille du tableau, a savoir la taille d'un objet multipliee par le nombre d'objets dans le 
tableau. 

Exemple 8-21. Determination de la taille de l'en-tete des tableaux 

tinclude <stdio.h> 

int buffer [25 6 ] ; // Buffer servant a stocker le tableau. 

class Temp 
{ 

char i[13]; // sizeof (Temp) doit etre premier. 

public : 

static void *operator new [ ] (size_t taille) 
{ 

return buffer; 

} 

static void operator delete [] (void *p, size_t taille) 
{ 

printf ( "Taille de l'en-tete : %d\n", 

taille- (taille/sizeof (Temp) ) *sizeof (Temp) ) ; 

return ; 
} 
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}; 

int main (void) 
{ 

delete [] new Temp[l]; 

return 0; 
} 

II est a noter qu'aucun des operateurs new, delete, new [ ] et delete [ ] ne recoit le pointeur this 
en parametre : ce sont des operateurs statiques. Cela est normal puisque, lorsqu'ils s'executent, soit 
l'objet n'est pas encore cree, soit il est deja detruit. Le pointeur this n'existe done pas encore (ou 
n'est plus valide) lors de l'appel de ces operateurs. 

Les operateurs new et new [ ] peuvent avoir une forme encore un peu plus compliquee, qui permet de 
leur passer des parametres lors de 1' allocation de la memoire. Les parametres supplementaires doivent 
imperativement etre les parametres deux et suivants, puisque le premier parametre indique toujours la 
taille de la zone de memoire a allouer. 

Comme le premier parametre est calcule par le compilateur, il n'y a pas de syntaxe permettant de le 
passer aux operateurs new et new [ ] . En revanche, une syntaxe speciale est necessaire pour passer les 
parametres supplementaires. Cette syntaxe est detaillee ci-dessous. 

Si l'operateur new est declare de la maniere suivante dans la classe classe : 

static void *operator new(size_t taille, parametres); 

ou taille est la taille de la zone de memoire a allouer et parametres la liste des parametres 
additionnels, alors on doit l'appeler avec la syntaxe suivante : 

new (parametres) classe; 



Les parametres sont done passes entre parentheses comme pour une fonction normale. Le nom de la 
fonction est new, et le nom de la classe suit l'expression new comme dans la syntaxe sans parametres. 
Cette utilisation de new est appelee new avec placement. 

Le placement est souvent utilise afin de realiser des reallocations de memoire d'un objet a un autre. 
Par exemple, si Ton doit detruire un objet alloue dynamiquement et en reconstruire immediatement 
un autre du meme type, les operations suivantes se deroulent : 

1. appel du destructeur de l'objet (realise par l'expression delete) ; 

2. appel de l'operateur delete ; 

3. appel de l'operateur new ; 

4. appel du constructeur du nouvel objet (realise par l'expression new). 

Cela n'est pas tres efficace, puisque la memoire est restituee pour etre allouee de nouveau immediate- 
ment apres. II est beaucoup plus logique de reutiliser la memoire de l'objet a detruire pour le nouvel 
objet, et de reconstruire ce dernier dans cette memoire. Cela peut se faire comme suit : 

1. appel explicite du destructeur de l'objet a detruire ; 

2. appel de new avec comme parametre supplemental le pointeur sur l'objet detruit ; 

3. appel du constructeur du deuxieme objet (realise par l'expression new). 
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L'appel de new ne fait alors aucune allocation : on gagne ainsi beaucoup de temps. 

Exemple 8-22. Operateurs new avec placement 

#include <stdlib.h> 
class A 

// Constructeur. 



public : 








A(void) 






{ 










return 


i 




} 








~A( 


void) 






{ 










return 


i 



II Destructeur. 



} 

// L' operateur new suivant utilise le placement. 

// II recoit en parametre le pointeur sur le bloc 

// a utiliser pour la requete d' allocation dynamique 

// de memoire. 

static void *operator new (size_t taille, A *bloc) 

{ 

return (void *) bloc; 
} 

// Operateur new normal : 

static void *operator new(size_t taille) 

{ 

// Implementation : 

return malloc (taille) ; 
} 

// Operateur delete normal : 

static void operator delete (void *pBlock) 

{ 

free (pBlock) ; 

return ; 
} 

}; 

int main (void) 
{ 

A *pA=new A; // Creation d' un objet de classe A. 

// L' operateur new global du C++ est utilise. 

pA->~A(); // Appel explicite du destructeur de A. 

A *pB=new(&pA) A; // Reutilisation de la memoire de A. 

delete pB; // Destruction de 1' objet. 

return 0; 
} 

Dans cet exemple, la gestion de la memoire est realisee par les operateurs new et delete normaux. 
Cependant, la reutilisation de la memoire allouee se fait grace a un operateur new avec placement, 
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defini pour l'occasion. Ce dernier ne fait strictement rien d' autre que de renvoyer le pointeur qu'on 
lui a passe en parametre. On notera qu'il est necessaire d'appeler explicitement le destructeur de la 
classe A avant de reutiliser la memoire de l'objet, car aucune expression delete ne s'en charge avant 
la reutilisation de la memoire. 

Note : Les operateurs new et delete avec placement predefinis par la bibliotheque standard C++ 
effectuent exactement ce que les operateurs de cet exemple font. II n'est done pas necessaire de 
les definir, si on ne fait aucun autre traitement que de reutiliser le bloc memoire que I'operateur 
new regoit en parametre. 



II est impossible de passer des parametres a I'operateur delete dans une expression delete. Cela 
est du au fait qu'en general on ne connait pas le contexte de la destruction d'un objet (alors qu'a 
l'allocation, on connait le contexte de creation de l'objet). Normalement, il ne peut done y avoir 
qu'un seul operateur delete. Cependant, il existe un cas ou Ton connait le contexte de l'appel de 
I'operateur delete : e'est le cas ou le constructeur de la classe lance une exception (voir le Cha- 
pitre 9 pour plus de details a ce sujet). Dans ce cas, la memoire allouee par I'operateur new doit 
etre restituee et I'operateur delete est automatiquement appele, puisque l'objet n'a pas pu etre 
construit. Afin d'obtenir un comportement symetrique, il est permis de donner des parametres ad- 
ditionnels a I'operateur delete. Lorsqu'une exception est lancee dans le constructeur de l'objet 
alloue, I'operateur delete appele est I'operateur dont la liste des parametres correspond a celle 
de I'operateur new qui a ete utilise pour creer l'objet. Les parametres passes a I'operateur delete 
prennent alors exactement les memes valeurs que celles qui ont ete donnees aux parametres de 
I'operateur new lors de l'allocation de la memoire de l'objet. Ainsi, si I'operateur new a ete utili- 
se sans placement, I'operateur delete sans placement sera appele. En revanche, si I'operateur new a 
ete appele avec des parametres, I'operateur delete qui a les memes parametres sera appele. Si aucun 
operateur delete ne correspond, aucun operateur delete n'est appele (si I'operateur new n'a pas 
alloue de memoire, cela n'est pas grave, en revanche, si de la memoire a ete allouee, elle ne sera pas 
restituee). II est done important de definir un operateur delete avec placement pour chaque operateur 
new avec placement defini. L' exemple precedent doit done etre reecrit de la maniere suivante : 

#include <stdlib.h> 

static bool bThrow = false; 

class A 
{ 
public : 

A(void) // Constructeur. 

{ 

// Le constructeur est susceptible 
// de lancer une exception : 
if (bThrow) throw 2; 
return ; 
} 

~A(void) // Destructeur. 

{ 

return ; 



// L' operateur new suivant utilise le placement. 
// II regoit en parametre le pointeur sur le bloc 
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II a utiliser pour la requete d' allocation dynamique 

// de memoire. 

static void *operator new (size_t taille, A *bloc) 

{ 

return (void *) bloc; 



// L' operateur delete suivant est utilise dans les expressions 
// qui utilisent 1' operateur new avec placement ci-dessus, 
// si une exception se produit dans le constructeur . 
static void operator delete (void *p, A *bloc) 
{ 

// On ne fait rien, parce que 1' operateur new correspondant 

// n'a pas alloue de memoire. 

return ; 
} 

// Operateur new et delete normaux : 
static void *operator new(size_t taille) 
{ 

return malloc (taille) ; 



static void operator delete (void *pBlock) 
{ 

free (pBlock) ; 

return ; 
} 
}; 

int main (void) 
{ 

A *pA=new A; // Creation d' un objet de classe A. 

pA->~A(); // Appel explicite du destructeur de A. 

bThrow = true; // Maintenant, le constructeur de A lance 
// une exception. 

try 

{ 

A *pB=new (pA) A; // Reutilisation de la memoire de A. 

// Si une exception a lieu, 1' operateur 
// delete (void *, A *) avec placement 
// est utilise. 
delete pB; // Destruction de 1' objet. 

} 

catch (...) 

{ 

// L' operateur delete (void *, A *) ne libere pas la memoire 
// allouee lors du premier new. II faut done quand meme 
// le faire, mais sans delete, car 1' objet pointe par pA 
// est deja detruit, et celui pointe par pB l'a ete par 
// 1' operateur delete (void *, A *) : 
free (pA) ; 



return 0; 



} 
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Note : II est possible d'utiliser le placement avec les operateurs newu et delete u exactement 
de la meme maniere qu'avec les operateurs new et delete. 

On notera que lorsque I'operateur new est utilise avec placement, si le deuxieme argument 
est de type size_t, I'operateur delete a deux arguments peut etre interprete soit comme un 
operateur delete classique sans placement mais avec deux parametres, soit comme I'operateur 
delete avec placement correspondant a I'operateur new avec placement. Afin de resoudre cette 
ambigui'te, le compilateur interprete systematiquement I'operateur delete avec un deuxieme 
parametre de type size_t comme etant I'operateur a deux parametres sans placement. II est done 
impossible de definir un operateur delete avec placement s'il a deux parametres, le deuxieme 
etant de type size_t. II en est de meme avec les operateurs new [ ] et delete [ ] . 



Quelle que soit la syntaxe que vous desirez utiliser, les operateurs new, new [ ] , delete et delete [ ] 
doivent avoir un comportement bien determine. En particulier, les operateurs delete et delete [] 
doivent pouvoir accepter un pointeur nul en parametre. Lorsqu'un tel pointeur est utilise dans une 
expression delete, aucun traitement ne doit etre fait. 

Enfin, vos operateurs new et new [ ] doivent, en cas de manque de memoire, appeler un gestionnaire 
d'erreur. Le gestionnaire d'erreur fourni par defaut lance une exception de classe std::bad_alloc (voir 
le Chapitre 9 pour plus de details sur les exceptions). Cette classe est definie comme suit dans le 
fichier d'en-tete new : 

class bad_alloc : public exception 

{ 

public : 

bad_alloc (void) throw (); 

bad_alloc (const bad_alloc &) throw (); 

bad_alloc &operator= (const bad_alloc &) throw (); 

virtual ~bad_alloc (void) throw (); 

virtual const char *what (void) const throw (); 

}; 



Note : Comme son nom I'indique, cette classe est definie dans I'espace de nommage std: :. Si 
vous ne voulez pas utiliser les notions des espaces de nommage, vous devrez inclure le fichier 
d'en-tete new . h au lieu de new. Vous obtiendrez de plus amples renseignements sur les espaces 
de nommage dans le Chapitre 1 1 . 



La classe exception dont bad_alloc herite est declaree comme suit dans le fichier d'en-tete 

exception : 

class exception 

{ 

public : 

exception (void) throw (); 

exception (const exception &) throw (); 

exception &operator= (const exception &) throw (); 

virtual -exception (void) throw (); 

virtual const char *what (void) const throw (); 

}; 



Note : Vous trouverez plus d'informations sur les exceptions dans le Chapitre 9. 
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Si vous desirez remplacer le gestionnaire par defaut, vous pouvez utiliser la fonction 
std: : set_new_handler. Cette fonction attend en parametre le pointeur sur le gestionnaire 
d'erreur a installer et renvoie le pointeur sur le gestionnaire d'erreur precedemment installe. 
Les gestionnaires d'erreurs ne prennent aucun parametre et ne renvoient aucune valeur. Leur 
comportement doit etre le suivant : 



soit ils prennent les mesures necessaires pour permettre l'allocation du bloc de memoire demande 
et rendent la main a l'operateur new. Ce dernier refait alors une tentative pour allouer le bloc de 
memoire. Si cette tentative echoue a nouveau, le gestionnaire d'erreur est rappele. Cette boucle se 
poursuit jusqu'a ce que l'operation se deroule correctement ou qu'une exception std::bad_alloc soit 
lancee ; 

soit ils lancent une exception de classe std::bad_alloc ; 

soit ils terminent l'execution du programme en cours. 



La bibliotheque standard definit une version avec placement des operateurs new et new [ ] , qui ren- 
voient le pointeur nul au lieu de lancer une exception en cas de manque de memoire. Ces operateurs 
prennent un deuxieme parametre, de type std::nothrow_t, qui doit etre specifie lors de l'appel. La 
bibliotheque standard definit un objet constant de ce type afin que les programmes puissent l'utiliser 
sans avoir a le definir eux-meme. Cet objet se nomme std : : nothrow 

Exemple 8-23. Utilisation de new sans exception 

char *data = new (std: :nothrow) char [25]; 

if (data == NULL) 

{ 

// Traitement de l'erreur... 



Note : La plupart des compilateurs ne respectent pas les regies dictees par la norme C++. En 
effet, ils preferent retourner la valeur nulle en cas de manque de memoire au lieu de lancer 
une exception. On peut rendre ces implementations compatibles avec la norme en installant un 
gestionnaire d'erreur qui lance lui-meme I'exception std::bad_alloc. 



8.12. Des entrees - sorties simplifies 



Les flux d' entree / sortie de la bibliotheque standard C++ constituent sans doute l'une des applications 
les plus interessantes de la surcharge des operateurs. Comme nous allons le voir, la surcharge des 
operateurs << et >> permet d'ecrire et de lire sur ces flux de maniere tres intuitive. 

En effet, la bibliotheque standard C++ definit dans l'en-tete iostream des classes extremement puis- 
santes permettant de manipuler les flux d' entree / sortie. Ces classes realisent en particulier les ope- 
rations d' entree / sortie de et vers les peripheriques d' entree et les peripheriques de sortie standards 
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(generalement, le clavier et l'ecran), mais dies ne s'arretent pas la : elles permettent egalement de 
travailler sur des fichiers ou encore sur des tampons en memoire. 

Les classes d' entree / sortie de la bibliotheque standard C++ permettent done d'effectuer les memes 
operations que les fonctions printf et scanf de la bibliotheque C standard. Cependant, grace au 
mecanisme de surcharge des operateurs, elles sont beaucoup plus faciles d' utilisation. En effet, les 
operateurs << et >> de ces classes ont ete surcharges pour chaque type de donnee du langage, 
permettant ainsi de realiser des entrees / sorties typees extremement facilement. L'operateur <<, 
egalement appelee operateur d'insertion, sera utilise pour realiser des ecritures sur un flux de donnees, 
tandis que l'operateur >>, ou operateur d'extraction, permettra de realiser la lecture d'une nouvelle 
donnee dans le flux d'entree. Ces deux operateurs renvoient tous les deux le flux de donnees utilise, 
ce qui permet de realiser plusieurs operations d'entree / sortie successivement sur le meme flux. 

Note : Cette section n'a pas pour but de decrire en detail les flux d'entree / sortie de la biblio- 
theque standard C++, mais plutot d'en faire une presentation simple permettant de les utiliser 
sans avoir a se plonger prematurement dans des notions extremement evoluees. Vous trouverez 
une description exhaustive des mecanismes des flux d'entree / sortie de la bibliotheque standard 
C++ dans le Chapitre 15. 



La bibliotheque standard definit quatre instances particulieres de ses classes d'entree / sortie : cin, 
cout, cerr et clog. Ces objets sont des instances des classes istream et ostream, prenant respecti- 
vement en charge 1'entree et la sortie des donnees des programmes. L' objet cin correspond au flux 
d'entree standard stdin du programme, et 1'objet cout aux flux de sortie standard stdout. En- 
fin, les objets cerr et clog sont associes au flux d'erreurs standard stderr. Theoriquement, cerr 
doit etre utilise pour 1'ecriture des messages d'erreur des programmes, et clog pour les messages 
d' information. Cependant, en pratique, les donnees ecrites sur ces deux flux sont ecrites dans le meme 
flux, et l'emploi de 1'objet clog est assez rare. 

L'utilisation des operateurs d'insertion et d'extraction sur ces flux se resume done a la syntaxe 
suivante : 

cin >> variable [>> variable [...]]; 
cout << valeur [<< valeur [...]]; 

Comme on le voit, il est possible d'effectuer plusieurs entrees ou plusieurs sortie successivement sur 
un meme flux. 

De plus, la bibliotheque standard definie ce que Ton appelle des manipulateurs permettant de realiser 
des operations simples sur les flux d'entree / sortie. Le manipulateur le plus utilise est sans nul doute 
le manipulateur endl qui, comme son nom l'indique, permet de signaler une fin de ligne et d'effectuer 
un saut de ligne lorsqu'il est employe sur un flux de sortie. 

Exemple 8-24. Flux d'entree / sortie cin et cout 

#include <iostream> 

using namespace std; 

int main (void) 
{ 

int i; 

// Lit un entier : 

cin >> i; 

// Affiche cet entier et le suivant : 
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cout << 
return 0; 



<< 



<< i+1 << endl; 



Note : Comme on le verra dans le Chapitre 15, les manipulateurs sont en realite des fonctions 
pour le type desquelles un operateur << ou un operateur >> a ete defini dans les classes 
d'entree / sortie. Ces operateurs appellent ces fonctions, qui effectuent chacune des modifica- 
tions specifiques sur le flux sur lequel elles travaillent. 

Les flux d'entree / sortie cin, cout cerr et clog sont declares dans I'espace de nommage stci: : 
de la bibliotheque standard C++. On devra done faire preceder leur nom du prefixe std: : pour 
y acceder, ou utiliser un directive using pour importer les symboles de la bibliotheque standard 
C++ dans I'espace de nommage global. Vous trouverez de plus amples renseignements sur les 
espaces de nommages dans le Chapitre 1 1 . 



Les avantages des flux C++ sont nombreux, on notera en particulier ceux-ci : 



le type des donnee est automatiquement pris en compte par les operateurs d' insertion et 
d' extraction (ils sont surcharges pour tous les types predefinis) ; 

les operateurs d' extraction travaillent par reference (on ne risque plus d'omettre V operateur & dans 
lafonction scant) ; 

il est possible de definir des operateurs d' insertion et d' extraction pour d'autres types de donnees 
que les types de base du langage ; 



leur utilisation est globalement plus simple. 



Les flux d'entree / sortie definis par la bibliotheque C++ sont done d'une extreme souplesse et sont 
extensibles aux types de donnees utilisateur. Par ailleurs, ils disposent d'un grand nombre de para- 
metres de formatage et d'options avancees. Toutes ces fonctionnalites seront decrites dans le Chapitre 
15, ou nous verrons egalement comment realiser des entrees / sorties dans des fichiers. 



8.13. Methodes virtuelles 

Les methodes virtuelles n'ont strictement rien a voir avec les classes virtuelles, bien qu'elles utilisent 
le meme mot cle virtual. Ce mot cle est utilise ici dans un contexte et dans un sens different. 

Nous savons qu'il est possible de redefinir les methodes d'une classe mere dans une classe fille. Lors 
de l'appel d'une fonction ainsi redefinie, la fonction appelee est la derniere fonction definie dans la 
hierarchie de classe. Pour appeler la fonction de la classe mere alors qu'elle a ete redefinie, il faut 
preciser le nom de la classe a laquelle elle appartient avec l'operateur de resolution de portee ( : : ). 

Bien que simple, cette utilisation de la redefinition des methodes peut poser des problemes. Supposons 
qu'une classe B herite de sa classe mere A. Si A possede une methode x appelant une autre methode y 
redefinie dans la classe fille B, que se passe-t-il lorsqu'un objet de classe B appelle la methode x ? La 
methode appelee etant celle de la classe A, elle appellera la methode y de la classe A. Par consequent, 
la redefinition de y ne sert a rien des qu'on F appelle a partir d'une des fonctions d'une des classes 
meres. 

Une premiere solution consisterait a redefinir la methode x dans la classe B. Mais ce n'est ni elegant, 
ni efficace. II faut en fait forcer le compilateur a ne pas faire le lien dans la fonction x de la classe 
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A avec la fonction y de la classe A. II faut que x appelle soit la fonction y de la classe A si elle 
est appelee par un objet de la classe A, soit la fonction y de la classe B si elle est appelee pour un 
objet de la classe B. Le lien avec l'une des methodes y ne doit etre fait qu'au moment de l'execution, 
c'est-a-dire qu'on doit faire une edition de liens dynamique. 

Le C++ permet de faire cela. Pour cela, il suffit de declarer virtuelle la fonction de la classe de base 
qui est redefinie dans la classe fille, c'est-a-dire la fonction y. Cela se fait en faisant preceder par le 

mot cle virtual dans la classe de base. 

Exemple 8-25. Redefinition de methode de classe de base 

#include <iostream> 

using namespace std; 

// Definit la classe de base des donnees. 

class DonneeBase 

{ 

protected: 

int Numero; // Les donnees sont numerotees. 

int Valeur; // et sont constitutes d'une valeur entiere 
// pour les donnees de base. 
public : 

void Entre (void) ; // Entre une donnee. 

void MiseAJour (void) ; // Met a jour la donnee. 
}; 

void DonneeBase :: Entre (void) 
{ 

cin >> Numero; // Entre le numero de la donnee. 

cout << endl; 

cin >> Valeur; // Entre sa valeur. 

cout << endl; 

return; 
} 

void DonneeBase : :MiseAJour (void) 
{ 

Entre (); // Entre une nouvelle donnee 

// a la place de la donnee en cours . 

return; 
} 

/* Definit la classe des donnees detaillees. */ 

class DonneeDetaillee : private DonneeBase 
{ 

int ValeurEtendue; // Les donnees detaillees ont en plus 

// une valeur etendue. 

public : 

void Entre (void) ; // Redefinition de la methode d' entree. 
}; 

void DonneeDetaillee: : Entre (void) 
{ 
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DonneeBase : : Entre ( ) ; // Appelle la methode de base, 

cin >> ValeurEtendue; // Entre la valeur etendue. 
cout << endl; 
return; 
} 

Si d est un objet de la classe DonneeDetaillee, l'appel de d . Entre ne causera pas de probleme. En 
revanche, l'appel de d.MiseAJour ne fonctionnera pas correctement, car la fonction Entre appelee 
dans MiseAJour est la fonction de la classe DonneeBase, et non la fonction redefinie dans Donnee- 
Detaille. 

II fallait declarer la fonction Entre comme une fonction virtuelle. II n'est necessaire de le faire que 
dans la classe de base. Celle-ci doit done etre declaree comme suit : 

class DonneeBase 

{ 

protected: 

int Numero; 

int Valeur; 

public : 

virtual void Entre (void) ; // Fonction virtuelle. 
void MiseAJour (void) ; 

}; 



Cette fois, la fonction Entre appelee dans MiseAJour est soit la fonction de la classe DonneeBase, 
si MiseAJour est appelee pour un objet de classe DonneeBase, soit celle de la classe DonneeDetaille 
si MiseAJour est appelee pour un objet de la classe DonneeDetaillee. 

En resume, les methodes virtuelles sont des methodes qui sont appelees selon la vraie classe de 
l'objet qui l'appelle. Les objets qui contiennent des methodes virtuelles peuvent etre manipules en 
tant qu'objets des classes de base, tout en effectuant les bonnes operations en fonction de leur type, 
lis apparaissent done comme etant des objets de la classe de base et des objets de leur classe complete 
indifferemment, et on peut les considerer soit comme les uns, soit comme les autres. Un tel comporte- 
ment est appele polymorphisme (e'est-a-dire qui peut avoir plusieurs aspects differents). Nous verrons 
une application du polymorphisme dans le cas des pointeurs sur les objets. 



8.14. Derivation 



Nous allons voir ici les regies de derivation. Ces regies permettent de savoir ce qui est autorise et ce 
qui ne Test pas lorsqu'on travaille avec des classes de base et leurs classes filles (ou classes derivees). 

La premiere regie, qui est aussi la plus simple, indique qu'il est possible d'utiliser un objet d'une 
classe derivee partout ou Ton peut utiliser un objet d'une de ses classes meres. Les methodes et 
donnees des classes meres appartiennent en effet par heritage aux classes filles. Bien entendu, on doit 
avoir les droits d'acces sur les membres de la classe de base que Ton utilise (Faeces peut etre restreint 
lors de l'heritage). 

La deuxieme regie indique qu'il est possible de faire une affectation d'une classe derivee vers une 
classe mere. Les donnees qui ne servent pas a l'initialisation sont perdues, puisque la classe mere ne 
possede pas les champs correspondants. En revanche, l'inverse est strictement interdit. En effet, les 
donnees de la classe fille qui n' existent pas dans la classe mere ne pourraient pas recevoir de valeur, 
et l'initialisation ne se ferait pas correctement. 
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Enfin, la troisieme regie dit que les pointeurs des classes derivees sont compatibles avec les pointeurs 
des classes meres. Cela signifie qu'il est possible d'affecter un pointeur de classe derivee a un pointeur 
d'une de ses classes de base. II faut bien entendu que Ton ait en outre le droit d'acceder a la classe 
de base, c'est-a-dire qu'au moins un de ses membres puisse etre utilise. Cette condition n'est pas 
toujours verifiee, en particulier pour les classes de base dont l'heritage est private. 

Un objet derive pointe par un pointeur d'une des classes meres de sa classe est considere comme un 
objet de la classe du pointeur qui le pointe. Les donnees specifiques a sa classe ne sont pas supprimees, 
elles sont seulement momentanement inaccessibles. Cependant, le mecanisme des methodes virtuelles 
continue de fonctionner correctement. En particulier, le destructeur de la classe de base doit etre 
declare en tant que methode virtuelle. Cela permet d'appeler le bon destructeur en cas de destruction 
de l'objet. 

II est possible de convertir un pointeur de classe de base en un pointeur de classe derivee si la classe 
de base n'est pas virtuelle. Cependant, meme lorsque la classe de base n'est pas virtuelle, cela est 
dangereux, car la classe derivee peut avoir des membres qui ne sont pas presents dans la classe de 
base, et l'utilisation de ce pointeur peut conduire a des erreurs tres graves. C'est pour cette raison 
qu'un transtypage est necessaire pour ce type de conversion. 

Soient par exemple les deux classes definies comme suit : 

tinclude <iostream> 

using namespace std; 

class Mere 

{ 

public : 

Mere (void) ; 

-Mere (void) ; 

}; 

Mere : :Mere (void) 
{ 

cout << "Constructeur de la classe mere." << endl; 

return; 
} 

Mere : : -Mere (void) 
{ 

cout << "Destructeur de la classe mere." << endl; 

return; 



class Fille : public Mere 

{ 

public : 

Fille (void) ; 

-Fille (void) ; 

}; 

Fille: :Fille (void) : MereO 
{ 

cout << "Constructeur de la classe fille." << endl; 

return; 
} 
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Fille: :~Fille(void) 
{ 

cout << "Destructeur de la classe fille." << endl; 

return; 
} 



Avec ces definitions, seule la premiere des deux affectations suivantes est autorisee : 

Mere m; // Instanciation de deux objets. 
Fille f; 

m=f; // Cela est autorise, mais 1' inverse ne le serait pas 
f=m; // ERREUR ! ! (ne compile pas) . 



Les memes regies sont applicables pour les pointeurs d'objets : 

Mere *pm, m; 

Fille *pf, f; 

pf=&f; // Autorise. 

pm=pf; // Autorise. Les donnees et les methodes 

// de la classe fille ne sont plus accessibles 

// avec ce pointeur : *pm est un objet 

// de la classe mere. 
pf=&m; // ILLEGAL : il faut faire un transtypage : 
pf= (Fille *) &m; // Cette fois, c'est legal, mais DANGEREUX ! 

// En effet, les methodes de la classe filles 

// ne sont pas definies, puisque m est une classe mere. 



L' utilisation d'un pointeur sur la classe de base pour acceder a une classe derivee necessite d'utiliser 
des methodes virtuelles. En particulier, il est necessaire de rendre virtuels les destructeurs. Par 
exemple, avec la definition donnee ci-dessus pour les deux classes, le code suivant est faux : 

Mere *pm; 

Fille *pf = new Fille; 

pm = p f ; 

delete pm; // Appel du destructeur de la classe mere ! 



Pour resoudre le probleme, il faut que le destructeur de la classe mere soit virtuel (il est inutile de 
declarer virtuel le destructeur des classes filles) : 

class Mere 

{ 

public : 

Mere (void) ; 

virtual -Mere (void) ; 

}; 
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On notera que bien que l'operateur delete soit une fonction statique, le bon destructeur est appele, 
car le destructeur est declare virtual. En effet, l'operateur delete recherche le destructeur a appe- 
ler dans la classe de l'objet le plus derive. De plus, l'operateur delete restitue la memoire de l'objet 
complet, et pas seulement celle du sous-objet reference par le pointeur utilise dans l'expression de- 
lete. Lorsqu'on utilise la derivation, il est done tres important de declarer les destructeurs virtuels 
pour que l'operateur delete utilise le vrai type de l'objet a detruire. 



8.15. Methodes virtuelles pures - Classes abstraites 

Une methode virtuelle pure est une methode qui est declaree mais non definie dans une classe. Elle 
est definie dans une des classes derivees de cette classe. 

Une classe abstraite est une classe comportant au moins une methode virtuelle pure. 

Etant donne que les classes abstraites ont des methodes non definies, il est impossible d'instancier des 
objets pour ces classes. En revanche, on pourra les referencer avec des pointeurs. 

Le mecanisme des methodes virtuelles pures et des classes abstraites permet de creer des classes de 
base contenant toutes les caracteristiques d'un ensemble de classes derivees, pour pouvoir les manipu- 
ler avec un unique type de pointeur. En effet, les pointeurs des classes derivees sont compatibles avec 
les pointeurs des classes de base, on pourra done referencer les classes derivees avec des pointeurs 
sur les classes de base, done avec un unique type sous-jacent : celui de la classe de base. Cependant, 
les methodes des classes derivees doivent exister dans la classe de base pour pouvoir etre accessibles 
a travers le pointeur sur la classe de base. C'est ici que les methodes virtuelles pures apparaissent. 
Elles forment un moule pour les methodes des classes derivees, qui les definissent. Bien entendu, il 
faut que ces methodes soient declarees virtuelles, puisque l'acces se fait avec un pointeur de classe de 
base et qu'il faut que ce soit la methode de la classe reelle de l'objet (e'est-a-dire la classe derivee) 
qui soit appelee. 

Pour declarer une methode virtuelle pure dans une classe, il suffit de faire suivre sa declaration de 
« =0 ». La fonction doit egalement etre declaree virtuelle : 

virtual type nom (parametres ) =0; 

= signifie ici simplement qu'il n'y a pas d' implementation de cette methode dans cette classe. 

Note : =o doit etre place completement en fin de declaration, e'est-a-dire apres le mot cle const 
pour les methodes const et apres la declaration de la liste des exceptions autorisees (voir le 
Chapitre 9 pour plus de details a ce sujet). 



Un exemple vaut mieux qu'un long discours. Soit done, par exemple, a construire une structure de 
donnees pouvant contenir d'autres structures de donnees, quels que soient leurs types. Cette structure 
de donnees est appelee un conteneur, parce qu'elle contient d'autres structures de donnees. II est pos- 
sible de definir differents types de conteneurs. Dans cet exemple, on ne s'interessera qu'au conteneur 
de type sac. 

Un sac est un conteneur pouvant contenir zero ou plusieurs objets, chaque objet n' etant pas forcement 
unique. Un objet peut done etre place plusieurs fois dans le sac. Un sac dispose de deux fonctions 
permettant d'y mettre et d'en retirer un objet. II a aussi une fonction permettant de dire si un objet se 
trouve dans le sac. 

Nous allons declarer une classe abstraite qui servira de classe de base pour tous les objets utilisables. 
Le sac ne manipulera que des pointeurs sur la classe abstraite, ce qui permettra son utilisation pour 
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toute classe derivant de cette classe. Afin de differencier deux objets egaux, un numero unique devra 
etre attribue a chaque objet manipule. Le choix de ce numero est a la charge des objets, la classe 
abstraite dont ils derivent devra done avoir une methode renvoyant ce numero. Les objets devront 
tous pouvoir etre affiches dans un format qui leur est propre. La fonction a utiliser pour cela sera 
print. Cette fonction sera une methode virtuelle pure de la classe abstraite, puisqu'elle devra etre 
definie pour chaque objet. 

Passons maintenant au programme... 

Exemple 8-26. Conteneur d'objets polymorphiques 

#include <iostream> 

using namespace std; 

/************* LA CLASSE ABSTRAITE DE BASE *****************/ 

class Object 
{ 

unsigned long int new_handle (void) ; 

protected: 

unsigned long int h; // Identifiant de 1' objet. 

public : 

Ob ject (void) ; // Le constructeur . 

virtual -Object (void) ; // Le destructeur virtuel. 

virtual void print (void) =0; // Fonction virtuelle pure, 
unsigned long int handle (void) const; // Fonction renvoyant 

// le numero d' identification 

// de 1' objet . 
}; 

// Cette fonction n'est appelable que par la classe Object : 

unsigned long int Ob ject :: new_handle (void) 
{ 

static unsigned long int he = 0; 

return he = he + 1; // he est 1' identifiant courant . 

// II est increments 
} //a chaque appel de new_handle . 

// Le constructeur de Object doit etre appele par les classes derivees : 

Object : :0b ject (void) 
{ 

h = new_handle ( ) ; // Trouve un nouvel identifiant. 

return; 
} 

Object : : -Object (void) 
{ 

return ; 
} 

unsigned long int Ob ject :: handle (void) const 
{ 
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return h; 



// Renvoie le numero de 1' objet. 



'******************** 



LA CLASSE SAC 



****************** 



I 



class Bag : public Object 



// La classe sac. Elle herite 

// de Object, car un sac peut 

// en contenir un autre. Le sac 

// est implements sous la forme 

// d'une liste chainee . 



struct BagList 



BagList *next; 
Object *ptr; 



}; 



BagList *head; 



// La tete de liste. 



public : 

Bag (void) ; // Le constructeur : appel celui de Object. 

-Bag(void); // Le destructeur. 

void print (void) ; // Fonction d' af f ichage du sac. 

bool has (unsigned long int) const; 

// true si le sac contient 1' objet. 

bool is_empty (void) const; // true si le sac est vide. 

void add(Object &); // Ajoute un objet. 

void remove (Object &); // Retire un objet. 
}; 

Bag : :Bag (void) : Object () 
{ 

return; // Ne fait rien d' autre qu' appeler Ob ject : : Ob ject ( ) . 



Bag : : -Bag (void) 
{ 

BagList *tmp = head; // Detruit la liste d' objet. 

while (tmp != NULL) 

{ 

tmp = tmp->next; 

delete head; 

head = tmp; 
} 
return; 



void Bag : :print (void) 
{ 

BagList *tmp = head; 

cout << "Sac n° " << handle () << "." << endl; 

cout << " Contenu : " << endl; 

while (tmp != NULL) 
{ 

cout << "\t"; // Indente la sortie des objets. 

tmp->ptr->print ( ) ; // Affiche la liste objets. 
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tmp = tmp->next; 
} 

return; 
} 

bool Bag :: has (unsigned long int h) const 
{ 

BagList *tmp = head; 

while (tmp != NULL && tmp->ptr->handle ( ) != h) 
tmp = tmp->next; // Cherche 1' objet. 

return (tmp != NULL) ; 
} 

bool Bag: : is_empty (void) const 
{ 

return (head==NULL) ; 



void Bag: : add (Ob ject So) 
{ 

BagList *tmp = new BagList; // Ajoute un objet a la liste. 

tmp->ptr = &o; 

tmp->next = head; 

head = tmp; 

return; 
} 

void Bag: : remove (Ob ject So) 
{ 

BagList *tmpl = head, *tmp2 = NULL; 

while (tmpl != NULL && tmpl->ptr->handle ( ) != o.handleO) 

{ 

tmp2 = tmpl; // Cherche 1' objet... 

tmpl = tmpl->next; 
} 

if (tmpl!=NULL) // et le supprime de la liste. 

{ 

if (tmp2!=NULL) tmp2->next = tmpl->next; 

else head = tmpl->next; 

delete tmpl; 
} 

return; 
} 

Avec la classe Bag definie telle quelle, il est a present possible de stacker des objets derivant de la 
classe Object avec les fonctions add et remove : 



class MonObjet : public Object 
{ 

/* Definir la methode print () pour l'objet... */ 

}; 

Bag MonSac; 

int main (void) 
{ 
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MonObjet a, b, c; // Effectue quelques operations 

// avec le sac : 
MonSac.add(a) ; 
MonSac. add (b) ; 
MonSac.add(c) ; 
MonSac. print () ; 
MonSac . remove (b ) ; 

MonSac . add (MonSac) ; // Un sac peut contenir un sac ! 
MonSac .print () ; // Attention ! Cet appel est recursif 

// (plantage assure) . 
return 0; 



Nous avons vu que la classe de base servait de moule aux classes derivees. Le droit d'empecher une 
fonction membre virtuelle pure definie dans une classe derivee d'acceder en ecriture non seulement 
aux donnees de la classe de base, mais aussi aux donnees de la classe derivee, peut done faire partie 
de ses prerogatives. Cela est faisable en declarant le pointeur this comme etant un pointeur constant 
sur objet constant. Nous avons vu que cela pouvait se faire en rajoutant le mot cle const apres la 
declaration de la fonction membre. Par exemple, comme l'identifiant de F objet de base est place en 
protected au lieu d'etre en private, la classe Object autorise ses classes derivees a le modifier. 
Cependant, elle peut empecher la fonction print de le modifier en la declarant const : 

class Object 
{ 

unsigned long int new_handle (void) ; 

protected: 

unsigned long int h; 

public : 

Ob ject (void) ; // Le constructeur . 

virtual void print (void) const=0; // Fonction virtuelle pure, 
unsigned long int handle (void) const; // Fonction renvoyant 

// le numero d' identification 
// de 1' objet . 
}; 



Dans l'exemple donne ci-dessus, la fonction print peut acceder en lecture a h, mais plus en ecriture. 
En revanche, les autres fonctions membres des classes derivees peuvent y avoir acces, puisque e'est 
une donnee membre protected. Cette methode d' encapsulation est done cooperative (elle requiert 
la bonne volonte des autres fonctions membres des classes derivees), tout comme la methode qui 
consistait en C a declarer une variable constante. Cependant, elle permettra de detecter des anomalies 
a la compilation, car si une fonction print cherche a modifier 1' objet sur lequel elle travaille, il y a 
manifestement une erreur de conception. 

Bien entendu, cela fonctionne egalement avec les fonctions membres virtuelles non pures, et meme 
avec les fonctions non virtuelles. 
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8.16. Pointeurs sur les membres d'une classe 

Nous avons deja vu les pointeurs sur les objets. II nous reste a voir les pointeurs sur les membres des 
classes. 

Les classes regroupent les caracteristiques des donnees et des fonctions des objets. Les membres des 
classes ne peuvent done pas etre manipules sans passer par la classe a laquelle ils appartiennent. Par 
consequent, il faut, lorsqu'on veut faire un pointeur sur un membre, indiquer le nom de sa classe. Pour 
cela, la syntaxe suivante est utilisee : 

definition classe::* pointeur 



Par exemple, si une classe test contient des entiers, le type de pointeurs a utiliser pour stocker leur 
adresse est : 

int test : : * 



Si on veut declarer un pointeur p de ce type, on ecrira done : 

int test::*pl; // Construit le pointeur sur entier 
// de la classe test. 



Une fois le pointeur declare, on pourra 1' initialiser en prenant 1' adresse du membre de la classe du type 
correspondant. Pour cela, il faudra encore specifier le nom de la classe avec 1'operateur de resolution 
de portee : 

pi = &test::i; // Recupere 1' adresse de i. 



La meme syntaxe est utilisable pour les fonctions. L'emploi d'un typedef est dans ce cas fortement 
recommande. Par exemple, si la classe test dispose d'une fonction membre appelee lit, qui n' attend 
aucun parametre et qui renvoie un entier, on pourra recuperer son adresse ainsi : 

typedef int (test::* pf) (void); // Definit le type de pointeur. 
pf p2 = &test : : lit ; // Construit le pointeur et 

// lit 1' adresse de la fonction. 



Cependant, ces pointeurs ne sont pas utilisables directement. En effet, les donnees d'une classe sont 
instanciees pour chaque objet, et les fonctions membres recoivent systematiquement le pointeur this 
sur l'objet de maniere implicite. On ne peut done pas faire un dereferencement direct de ces pointeurs. 
II faut specifier l'objet pour lequel le pointeur va etre utilise. Cela se fait avec la syntaxe suivante : 

objet . *pointeur 



Pour les pointeurs d'objet, on pourra utiliser 1'operateur ->* a la place de 1'operateur . * (appele 
pointeur sur operateur de selection de membre). 
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Ainsi, si a est un objet de classe test, on pourra acceder a la donnee i de cet objet a travers le pointeur 
p 1 avec la syntaxe suivante : 

a.*pl = 3; // Initialise la donnee membre i de a avec la valeur 3. 



Pour les fonctions membres, on mettra des parentheses a cause des priorites des operateurs 

int i = (a.*p2) (); // Appelle la fonction lit() pour l'objet a. 



Pour les donnees et les fonctions membres statiques, cependant, la syntaxe est differente. En effet, 
les donnees n'appartiennent plus aux objets de la classe, mais a la classe elle-meme, et il n'est plus 
necessaire de connaitre l'objet auquel le pointeur s'applique pour les utiliser. De meme, les fonctions 
membres statiques ne recoivent pas le pointeur sur l'objet, et on peut done les appeler sans referencer 
ce dernier. 

La syntaxe s'en trouve done modifiee. Les pointeurs sur les membres statiques des classes sont com- 
patibles avec les pointeurs sur les objets et les fonctions non-membres. Par consequent, si une classe 
contient une donnee statique entiere, on pourra recuperer son adresse directement et la mettre dans un 
pointeur d'entier : 

int *p3 = Stest : :entier_statique; // Recupere l'adresse 

// de la donnee membre 
// statique. 



La meme syntaxe s'appliquera pour les fonctions : 

typedef int (*pg) (void); 

pg p4 = Stest :: fonction_statique; // Recupere l'adresse 

// d' une fonction membre 

// statique. 



Enfin, l'utilisation des ces pointeurs est identique a celle des pointeurs classiques, puisqu'il n'est 
pas necessaire de fournir le pointeur this. II est done impossible de specifier le pointeur sur l'objet 
sur lequel la fonction doit travailler aux fonctions membres statiques. Cela est naturel, puisque les 
fonctions membres statiques ne peuvent pas acceder aux donnees non statiques d'une classe. 

Exemple 8-27. Pointeurs sur membres statiques 

#include <iostream> 

using namespace std; 

class test 
{ 

int i; 

static int j ; 

public : 

test (int j ) 
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return ; 
} 

static int get (void) 
{ 

/* return i ; INTERDIT : i est non statique 
et get l'est ! */ 

return j ; // Autorise. 
} 

}; 

int test::j=5; // Initialise la variable statique. 

typedef int (*pf) (void); // Pointeur de fonction renvoyant 

// un entier. 

pf p=&test : : get; // Initialisation licite, car get 

// est statique. 

int main (void) 
{ 

cout << (*p) () << endl;// Affiche 5. On ne specifie pas l'objet. 

return 0; 
} 
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Une exception est l'interruption de l'execution du programme a la suite d'un evenement particulier. Le 
but des exceptions est de realiser des traitements specifiques aux evenements qui en sont la cause. Ces 
traitements peuvent retablir le programme dans son mode de fonctionnement normal, auquel cas son 
execution reprend. II se peut aussi que le programme se termine, si aucun traitement n'est approprie. 

Le C++ supporte les exceptions logicielles, dont le but est de gerer les erreurs qui surviennent lors 
de l'execution des programmes. Lorsqu'une telle erreur survient, le programme doit lancer une ex- 
ception. L'execution normale du programme s'arrete des que l'exception est lancee, et le controle 
est passe a un gestionnaire a" exception. Lorsqu'un gestionnaire d'exception s'execute, on dit qu'il a 
attrape l'exception. 

Les exceptions permettent une gestion simplifiee des erreurs, parce qu'elles en reportent le traitement. 
Le code peut alors etre ecrit sans se soucier des cas particuliers, ce qui le simplifie grandement. Les 
cas particuliers sont traites dans les gestionnaires d'exception. 

En general, une fonction qui detecte une erreur d'execution ne peut pas se terminer normalement. 
Comme son traitement n'a pas pu se derouler normalement, il est probable que la fonction qui l'a 
appelee considere elle aussi qu'une erreur a eu lieu et termine son execution. L' erreur remonte ainsi la 
liste des appelants de la fonction qui a genere l'erreur. Ce processus continue, de fonction en fonction, 
jusqu'a ce que l'erreur soit completement geree ou jusqu'a ce que le programme se termine (ce cas 
survient lorsque la fonction principale ne peut pas gerer l'erreur). 

Traditionnellement, ce mecanisme est implemente a l'aide de codes de retour des fonctions. Chaque 
fonction doit renvoyer une valeur specifique a Tissue de son execution, permettant d'indiquer si elle 
s'est correctement deroulee ou non. La valeur renvoyee est done utilisee par l'appelant pour deter- 
miner la nature de l'erreur, et, si erreur il y a, prendre les mesures necessaires. Cette methode per- 
met a chaque fonction de liberer les ressources qu'elle a allouees lors de la remontee des erreurs, et 
d'effectuer ainsi sa part du traitement d'erreur. 

Malheureusement, cette technique necessite de tester les codes de retour de chaque fonction appelee, 
et la logique d'erreur developpee finit par devenir tres lourde, puisque ces tests s'imbriquent les uns 
a la suite des autres et que le code du traitement des erreurs se trouve melange avec le code du 
fonctionnement normal de l'algorithme. Cette complication peut devenir ingerable lorsque plusieurs 
valeurs de codes de retour peuvent etre renvoyees afin de distinguer les differents cas d' erreur possible, 
car il peut en decouler un grand nombre de tests et beaucoup de cas particuliers a gerer dans les 
fonctions appelantes. 

Certains programmes utilisent done une solution astucieuse, qui consiste a deporter le traitement des 
erreurs a effectuer en dehors de l'algorithme par des sauts vers la fin de la fonction. Le code de net- 
toyage, qui se trouve alors apres l'algorithme, est execute completement si tout se passe correctement. 
En revanche, si la moindre erreur est detectee en cours d'execution, un saut est realise vers la partie 
du code de nettoyage correspondante au traitement qui a deja ete effectue. Ainsi, ce code n'est ecrit 
qu'une seule fois, et le traitement des erreurs est situe en dehors du traitement normal. 

La solution precedente est tout a fait valable (en fait, e'est meme la solution la plus simple), mais elle 
souffre d'un inconvenient. Elle rend le programme moins structure, car toutes les ressources utilisees 
par l'algorithme doivent etre accessibles depuis le code de traitement des erreurs. Ces ressources 
doivent done etre placees dans une portee relativement globale, voire declarees en tete de fonction. De 
plus, le traitement des codes d'erreurs multiples pose toujours les memes problemes de complication 
des tests. 

La solution qui met en oeuvre les exceptions est beaucoup plus simple, puisque la fonction qui detecte 
une erreur peut se contenter de lancer une exception. Cette exception interrompt l'execution de la 
fonction, et un gestionnaire d'exception approprie est recherche. La recherche du gestionnaire suit 
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le meme chemin que celui utilise lors de la remontee des erreurs : a savoir la liste des appelants. 
La premiere fonction appelante qui contient un gestionnaire d' exception approprie prend done le 
controle, et effectue le traitement de l'erreur. Si le traitement est complet, le programme reprend 
son execution normale. Dans le cas contraire, le gestionnaire d' exception peut relancer 1' exception 
(auquel cas le gestionnaire d' exception suivant est recherche) ou terminer le programme. 

Le mecanisme des exceptions du C++ garantit que tous les objets de classe de stockage automatique 
sont detruits lorsque l'exception qui remonte sort de leur portee. Ainsi, si toutes les ressources sont 
encapsulees dans des classes disposant d'un destructeur capable de les detruire ou de les ramener 
dans un etat coherent, la remontee des exceptions effectue automatiquement le menage. De plus, 
les exceptions peuvent etre typees, et caracteriser ainsi la nature de l'erreur qui s'est produite. Ce 
mecanisme est done strictement equivalent en termes de fonctionnalites aux codes d'erreurs utilises 
precedemment. 

Comme on le voit, les exceptions permettent de simplifier le code, en reportant en dehors de 
l'algorithme normal le traitement des erreurs. Par ailleurs, la logique d'erreur est completement prise 
en charge par le langage, et le programmeur n'a plus a faire les tests qui permettent de determiner le 
traitement approprie pour chaque type d'erreur. Les mecanismes de gestion des exceptions du C++ 
sont decrits dans les paragraphes suivants. 

9.1. Lancement et recuperation d'une exception 

En C++, lorsqu'il faut lancer une exception, on doit creer un objet dont la classe caracterise cette 
exception, et utiliser le mot cle throw. Sa syntaxe est la suivante : 

throw objet; 

ou objet est 1' objet correspondant a l'exception. Cet objet peut etre de n'importequel type, etpourra 
ainsi caracteriser pleinement l'exception. 

L'exception doit alors etre traitee par le gestionnaire d' exception correspondant. On ne peut attraper 
que les exceptions qui sont apparues dans une zone de code limitee (cette zone est dite protegee contre 
les erreurs d' execution), pas sur tout un programme. On doit done placer le code susceptible de lancer 
une exception d'un bloc d' instructions particulier. Ce bloc est introduit avec le mot cle try : 

try 
{ 

// Code susceptible de generer des exceptions... 
} 



Les gestionnaires d'exceptions doivent suivre le bloc try. lis sont introduits avec le mot cle catch : 

catch (classe [&][temp]) 
{ 

// Traitement de l'exception associee a la classe 
} 



Notez que les objets de classe de stockage automatique definis dans le bloc try sont automatiquement 
detruits lorsqu'une exception fait sortir le controle du programme de leur portee. C'est egalement 
le cas de l'objet construit pour lancer l'exception. Le compilateur effectue done une copie de cet 
objet pour le transferer au premier bloc catch capable de le recevoir. Cela implique qu'il y ait un 
constructeur de copie pour les classes d'exceptions non triviales. 
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De meme, les blocs catch peuvent recevoir leurs parametres par valeur ou par reference, comme le 
montre la syntaxe indiquee ci-dessus. En general, il est preferable d' utiliser une reference, afin d'eviter 
une nouvelle copie de l'objet de l'exception pour le bloc catch. Toutefois, on prendra garde au fait 
que dans ce cas, les modifications effectuees sur le parametre seront effectuees dans la copie de travail 
du compilateur et seront done egalement visibles dans les blocs catch des fonctions appelantes ou 
de portee superieure, si l'exception est relancee apres traitement. 

II peut y avoir plusieurs gestionnaires d' exceptions. Chacun traitera les exceptions qui ont ete generees 
dans le bloc try et dont l'objet est de la classe indiquee par son parametre. II n'est pas necessaire de 
donner un nom a l'objet (temp) dans l'expression catch. Cependant, cela permet de le recuperer, ce 
qui peut etre necessaire si Ton doit recuperer des informations sur la nature de l'erreur. 

Enfin, il est possible de definir un gestionnaire d' exception universel, qui recuperera toutes les ex- 
ceptions possibles, quels que soient leurs types. Ce gestionnaire d'exception doit prendre comme 
parametre trois points de suspension entre parentheses dans sa clause catch. Bien entendu, dans ce 
cas, il est impossible de specifier une variable qui contient l'exception, puisque son type est indefini. 

Exemple 9-1. Utilisation des exceptions 

#include <iostream> 

using namespace std; 

class erreur // Premiere exception possible, associee 

// a l'objet erreur. 
{ 
public : 

int cause; // Entier specifiant la cause de l'exception. 

// Le constructeur . II appelle le constructeur de cause. 

erreur (int c) : cause (c) {} 

// Le constructeur de copie. II est utilise par le mecanisme 

// des exceptions : 

erreur (const erreur ssource) : cause (source . cause) {} 
}; 

class other { } ; // Ob jet correspondant a toutes 
// les autres exceptions. 

int main (void) 
{ 

int i; // Type de l'exception a generer. 

cout << "Tapez pour generer une exception Erreur, " 

"1 pour une Entiere :"; 
cin >> i; // On va generer une des trois exceptions 

// possibles, 
cout << endl; 

try // Bloc ou les exceptions sont prises en charge. 

{ 

switch (i) // Selon le type d'exception desiree, 
{ 

case : 
{ 

erreur a (0) ; 

throw (a); // on lance l'objet correspondant 
// (ici, de classe erreur) . 
// Cela interrompt le code, break est 
// done inutile ici. 
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case 1 : 



default : 
{ 



int a=l; 

throw (a); // Exception de type entier. 

// Si 1' utilisateur n'a pas tape ou 1, 

other c; // on cree l'objet c (type d' exception 
throw (c) ; // other) et on le lance. 



:• 



} 



// fin du bloc try. Les blocs catch suivent : 
catch (erreur &tmp) // Traitement de 1' exception erreur ... 
// (avec recuperation de la cause) . 
cout << "Erreur erreur ! (cause " << tmp. cause << ")" << endl; 

catch (int tmp) // Traitement de 1' exception int... 

cout << "Erreur int ! (cause " << tmp << ")" << endl; 

catch (...) // Traitement de toutes les autres 
// exceptions (...). 

// On ne peut pas recuperer l'objet ici. 
cout << "Exception inattendue !" << endl; 

return 0; 



Selon ce qu'entre 1' utilisateur, une exception du type erreur, int ou other est generee. 



9.2. Remontee des exceptions 



Les fonctions interessees par les exceptions doivent les capter avec le mot cle catch comme on 
l'a vu ci-dessus. Elles peuvent alors effectuer tous les traitements d'erreurs que le C++ ne fera pas 
automatiquement. Ces traitements comprennent generalement le retablissement de l'etat des donnees 
manipulees par la fonction (dont, pour les fonctions membres d'une classe, les donnees membres de 
l'objet courant), ainsi que la liberation des ressources non encapsulees dans des objets de classe de 
stockage automatique (par exemple, les fichiers ouverts, les connexions reseau, etc.). 

Une fois ce travail effectue, elles peuvent, si elles le desirent, relancer F exception, afin de permettre 
un traitement complementaire par leur fonction appelante. Le parcours de l'exception s'arretera done 
des que l'erreur aura ete completement traitee. Bien entendu, il est egalement possible de lancer une 
autre exception que celle que Ton a recue, comme ce peut etre par exemple le cas si le traitement de 
l'erreur provoque lui-meme une erreur. 

Pour relancer l'exception en cours de traitement dans un gestionnaire d'exception, il faut utiliser le 
mot cle throw. La syntaxe est la suivante : 

throw ; 

L'exception est alors relancee, avec comme valeur l'objet que le compilateur a construit en interne 
pour propager l'exception. Les gestionnaires d'exception peuvent done modifier les parametres des 
exceptions, s'ils les attrapent avec une reference. 
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Si, lorsqu'une exception se produit dans un bloc try, il est impossible de trouver le bloc catch 
correspondant a la classe de cette exception, il se produit une erreur d' execution. La fonction pre- 
definie std: : terminate est alors appelee. Elle se contente d'appeler une fonction de traitement 
de l'erreur, qui elle-meme appelle la fonction abort de la bibliotheque C. Cette fonction termine 
en catastrophe l'execution du programme fautif en generant une faute (les ressources allouees par le 
programme ne sont done pas liberees, et des donnees peuvent etre perdues). Ce n'est generalement 
pas le comportement desire, aussi est-il possible de le modifier en changeant la fonction appelee par 
std: :terminate. 

Pour cela, il faut utiliser la fonction std: : set_terminate, qui attend en parametre un pointeur 
sur la fonction de traitement d' erreur, qui ne prend aucun parametre et renvoie void. La valeur ren- 
voyee par std: : set_terminate est le pointeur sur la fonction de traitement d'erreur precedente. 

std: : terminate et std: : set_terminate sont declareee dans le fichier d'en-tete exception. 

Note : Comme leurs noms I'indiquent, std: :terminate et std: : set_terminate sont declarees 
dans I'espace de nommage std: : , qui est reserve pour tous les objets de la bibliotheque standard 
C++. Si vous ne voulez pas a avoir a utiliser systematiquement le prefixe std: : devant ces noms, 
vous devrez ajouter la ligne « using namespace std; » apres avoir inclus I'en-tete exception. 
Vous obtiendrez de plus amples renseignements sur les espaces de nommage dans le Chapitre 
11. 



Exemple 9-2. Installation d'un gestionnaire d'exception avec set_terminate 

#include <iostream> 
#include <exception> 

using namespace std; 

void mon_gestionnaire (void) 
{ 

cout << "Exception non geree recue !" << endl; 

cout << "Je termine le programme proprement . . . " 
<< endl; 

exit (-1) ; 
} 

int lance_exception (void) 

{ 

throw 2; 



int main (void) 
{ 

set_terminate (&mon_gestionnaire) ; 

try 

{ 

lance_exception ( ) ; 
} 

catch (double d) 
{ 

cout << "Exception de type double regue : " << 
d << endl; 
} 
return 0; 
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} 



9.3. Liste des exceptions autorisees pour une fonction 

II est possible de specifier les exceptions qui peuvent etre lancees par une fonction. Pour cela, il faut 
faire suivre son en-tete du mot cle throw avec, entre parentheses et separees par des virgules, les 
classes des exceptions qu'elle est autorisee a lancer. Par exemple, la fonction suivante : 

int f onction_sensible (void) 
throw (int, double, erreur) 



n'a le droit de lancer que des exceptions du type int, double ou erreur. Si une exception d'un autre 
type est lancee, par exemple une exception du type char *, il se produit encore une fois une erreur a 
1' execution. 

En fait, la fonction std: : unexpected est appelee. Cette fonction se comporte de maniere 
similaire a std: : terminate, puisqu'elle appelle par defaut une fonction de traitement de l'erreur 
qui elle-meme appelle la fonction std: terminate (et done abort en fin de compte). Cela 
conduit a la terminaison du programme. On peut encore une fois changer ce comportement par 
defaut en remplacant la fonction appelee par std: : unexpected par une autre fonction a l'aide de 
std: : set_unexpected, qui est declaree dans le fichier d'en-tete exception. Cette derniere 
attend en parametre un pointeur sur la fonction de traitement d'erreur, qui ne doit prendre aucun 
parametre et qui ne doit rien renvoyer. std: : set_unexpected renvoie le pointeur sur la fonction 
de traitement d'erreur precedemment appelee par std : : unexpected. 

Note : Comme leurs noms I'indiquent, std: : unexpected et std: :set_unexpected sont 
declarees dans I'espace de nommage std: :, qui est reserve pour les objets de la bibliotheque 
standard C++. Si vous ne voulez pas avoir a utiliser systematiquement le prefixe std: : pour ces 
noms, vous devrez ajouter la ligne « using namespace std; » apres avoir inclus I'en-tete 
exception. Vous obtiendrez de plus amples renseignements sur les espaces de nommage 
dans le Chapitre 1 1 . 



II est possible de relancer une autre exception a l'interieur de la fonction de traitement d'erreur. Si cette 
exception satisfait la liste des exceptions autorisees, le programme reprend son cours normalement 
dans le gestionnaire correspondant. C'est generalement ce que Ton cherche a faire. Le gestionnaire 
peut egalement lancer une exception de type std::bad_exception, declaree comme suit dans le fichier 
d'en-tete exception : 

class bad_exception : public exception 

{ 

public : 

bad_exception (void) throw)) ; 

bad_exception (const bad_exception &) throw (); 

bad_exception &operator= (const bad_exception &) throw (); 

virtual ~bad_exception (void) throw (); 

virtual const char *what (void) const throw (); 



Cela a pour consequence de terminer le programme. 
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Enfin, le gestionnaire d' exceptions non autorisees peut directement mettre fin a 1' execution 
du programme en appelant std: : terminate. C'est le comportement utilise par la fonction 
std : : unexpected definie par defaut. 

Exemple 9-3. Gestion de la liste des exceptions autorisees 

#include <iostream> 
#include <exception> 

using namespace std; 

void mon_gestionnaire (void) 
{ 

cout << "line exception illegale a ete lancee." << endl; 

cout << "Je relance une exception de type int." << endl; 

throw 2; 
} 

int f (void) throw (int) 
{ 

throw "5.35"; 
} 

int main (void) 
{ 

set_unexpected (&mon_gestionnaire) ; 

try 

{ 

f ; 
} 

catch (int i) 
{ 

cout << "Exception de type int regue : " << 
i << endl; 
} 
return 0; 



Note : La liste des exceptions autorisees dans une fonction ne fait pas partie de sa signature. 
Elle n'intervient done pas dans les mecanismes de surcharge des fonctions. De plus, elle doit se 
placer apres le mot cle const dans les declarations de fonctions membres const (en revanche, 
elle doit se placer avant =o dans les declarations des fonctions virtuelles pures). 

On prendra garde au fait que les exceptions ne sont pas generees par le mecanisme de gestion 
des erreurs du C++ (ni du C). Cela signifie que pour avoir une exception, il faut la lancer, le com- 
pilateur ne fera pas les tests pour vous (tests de debordements numeriques dans les calculs par 
exemple). Cela supposerait de predefinir un ensemble de classes pour les erreurs generiques. 
Les tests de validite d'une operation doivent done etre faits malgre tout et, le cas echeant, il 
faut lancer une exception pour reporter le traitement en cas d'echec. De meme, les exceptions 
generees par la machine hote du programme ne sont en general pas recuperees par les imple- 
mentations et, si elles le sont, les programmes qui les utilisent ne sont pas portables. 
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9.4. Hierarchie des exceptions 

Le mecanisme des exceptions du C++ se base sur le typage des objets, puisque le lancement d'une 
exception necessite la construction d'un objet qui la caracterise, et le bloc catch destination de cette 
exception sera selectionne en fonction du type de cet objet. Bien entendu, les objets utilises pour lancer 
les exceptions peuvent contenir des informations concernant la nature des erreurs qui se produisent, 
mais il est egalement possible de classifier ces erreurs par categories en se basant sur leurs types. 

En effet, les objets exceptions peuvent etre des instances de classes disposant de relations d'heritage. 
Comme les objets des classes derivees peuvent etre considered comme des instances de leurs classes 
de base, les gestionnaires d' exception peuvent recuperer les exceptions de ces classes derivees en 
recuperant un objet du type d'une de leurs classes de base. Ainsi, il est possible de classifier les 
differents cas d'erreurs en definissant une hierarchie de classe d' exceptions, et d'ecrire des traitements 
generiques en n'utilisant que les objets d'un certain niveau dans cette hierarchie. 

Le mecanisme des exceptions se montre done plus puissant que toutes les autres methodes de traite- 
ment d'erreurs a ce niveau, puisque la selection du gestionnaire d'erreur est automatiquement realisee 
par le langage. Cela peut etre tres pratique pour peu que Ton ait defini correctement sa hierarchie de 
classes d'exceptions. 

Exemple 9-4. Classification des exceptions 

#include <iostream> 
using namespace std; 



// Classe de base de toutes les exceptions : 
class ExRuntimeError 



// Classe de base des exceptions pouvant se produire 
// lors de manipulations de fichiers : 
class ExFileError : public ExRuntimeError 



// Classes des erreurs de manipulation des fichiers 
class ExInvalidName : public ExFileError 



class ExEndOfFile : public ExFileError 



class ExNoSpace : public ExFileError 



class ExMediumFull : public ExNoSpace 



class ExFileSizeMaxLimit : public ExNoSpace 
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II Fonction faisant un travail quelconque sur un fichier : 

void WriteData (const char *szFileName) 

{ 

// Exemple d'erreur : 

if (szFileName == NULL) throw ExInvalidName ( ) ; 

else 

{ 

// Traitement de la fonction 
// etc. 

// Lancement d'une exception : 
throw ExMediumFull () ; 
} 
} 

void Save (const char *szFileName) 
{ 

try 

{ 

WriteData (szFileName) ; 

} 

// Traitement d' un erreur specif ique : 

catch (ExInvalidName &) 

{ 

cout << "Impossible de faire la sauvegarde" << endl; 

} 

// Traitement de toutes les autres erreurs en groupe : 

catch (ExFileError S) 

{ 

cout << "Erreur d' entree / sortie" << endl; 

} 
} 

int main (void) 
{ 

Save (NULL) ; 

S ave ( " dat a . dat " ) ; 

return 0; 



La bibliotheque standard C++ definit elle-meme un certain nombre d' exceptions standards, qui sont 
utilisees pour signaler les erreurs qui se produisent a 1'execution des programmes. Quelques-unes de 
ces exceptions ont deja ete presentees avec les fonctionnalites qui sont susceptibles de les lancer. Vous 
trouverez une liste complete des exceptions de la bibliotheque standard du C++ dans la Section 13.2. 



9.5. Exceptions dans les constructeurs 

II est parfaitement legal de lancer une exception dans un constructeur. En fait, c'est meme la seule 
solution pour signaler une erreur lors de la construction d'un objet, puisque les constructeurs n'ont 
pas de valeur de retour. 

Lorsqu'une exception est lancee a partir d'un constructeur, la construction de l'objet echoue. Par 
consequent, le compilateur n'appellera jamais le destructeur pour cet objet, puisque cela n'a pas de 
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sens. Cependant, ce comportement souleve le probleme des objets partiellement initialises, pour les- 
quels il est necessaire de faire un peu de nettoyage a la suite du lancement de l'exception. Le C++ 
dispose done d'une syntaxe particuliere pour les constructeurs des objets susceptibles de lancer des 
exceptions. Cette syntaxe permet simplement d'utiliser un bloc try pour le corps de fonction des 
constructeurs. Les blocs catch suivent alors la definition du constructeur, et effectuent la liberation 
des ressources que le constructeur aurait pu allouer avant que l'exception ne se produise. 

Le comportement du bloc catch des constructeurs avec bloc try est different de celui des blocs 
catch classiques. En effet, les exceptions ne sont normalement pas relancees une fois qu'elles ont 
ete traitees. Comme on l'a vu ci-dessus, il faut utiliser explicitement le mot cle throw pour relancer 
une exception a Tissue de son traitement. Dans le cas des constructeurs avec un bloc try cependant, 
l'exception est systematiquement relancee. Le bloc catch du constructeur ne doit done prendre en 
charge que la destruction des donnees membres partiellement construites, et il faut toujours capter 
l'exception au niveau du programme qui a cherche a creer l'objet. 

Note : Cette demiere regie implique que les programmes declarant des objets globaux dont 
le constructeur peut lancer une exception risquent de se terminer en catastrophe. En effet, si 
une exception est lancee par ce constructeur a I'initialisation du programme, aucun gestionnaire 
d'exception ne sera en mesure de la capter lorsque le bloc catch la relancera. 



De meme, lorsque la construction de l'objet se fait dans le cadre d'une allocation dynamique de 
memoire, le compilateur appelle automatiquement l'operateur delete afin de restituer la memoire 
allouee pour cet objet. II est done inutile de restituer la memoire de l'objet alloue dans le traitement 
de l'exception qui suit la creation dynamique de l'objet, et il ne faut pas y appeler l'operateur delete 
manuellement. 

Note : Comme il l'a ete dit plus haut, le compilateur n'appelle pas le destructeur pour les objets 
dont le constructeur a genere une exception. Cette regie est valide meme dans le cas des objets 
alloues dynamiquement. Le comportement de l'operateur delete est done lui aussi legerement 
modifie par le fait que l'exception s'est produite dans un constructeur. 



Exemple 9-5. Exceptions dans les constructeurs 

#include <iostream> 
#include <stdlib.h> 

using namespace std; 

class A 
{ 

char *pBuffer; 

int *pData; 

public : 

A () throw (int) ; 

~A() 

{ 

cout << "A::~A()" << endl; 



static void *operator new(size_t taille) 
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cout << "new()" << endl; 
return malloc (taille) ; 



static void operator delete (void *p) 
{ 

cout << "delete" << endl; 

free (p) ; 



// Constructeur susceptible de lancer une exception 

A: :A() throw (int) 

try 

{ 

pBuffer = NULL; 

pData = NULL; 

cout << "Debut du constructeur" << endl; 

pBuffer = new char [256]; 

cout << "Lancement de 1' exception" << endl; 

throw 2; 

// Code inaccessible : 

pData = new int; 
} 

catch (int) 
{ 

cout << "Je fais le menage..." << endl; 

delete [] pBuffer; 

delete pData; 



int main (void) 
{ 

try 

{ 

A *a = new A; 

} 

catch (...) 

{ 

cout << "Aie, meme pas mal !" << endl; 

} 

return 0; 



Dans cet exemple, lors de la creation dynamique d'un objet A, une erreur d' initialisation se produit 
et une exception est lancee. Celle-ci est alors traitee dans le bloc catch qui suit la definition du 
constructeur de la classe A. L'operateur delete est bien appele automatiquement, mais le destructeur 
de A n'est jamais execute. 

En general, si une classe herite de une ou plusieurs classes de base, l'appel aux constructeurs des 
classes de base doit se faire entre le mot cle try et la premiere accolade. En effet, les constructeurs 
des classes de base sont susceptibles, eux aussi, de lancer des exceptions. La syntaxe est alors la 
suivante : 

Classe : :Classe 
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try : Base (parametres) [, Base (parametres ) [. 
{ 
} 
catch . . . 
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Le C++ est un langage fortement type. Malgre cela, il se peut que le type exact d'un objet soit inconnu 
a cause de l'heritage. Par exemple, si un objet est considere comme un objet d'une classe de base de 
sa veritable classe, on ne peut pas determiner a priori quelle est sa veritable nature. 

Cependant, les objets polymorphiques (qui, rappelons-le, sont des objets disposant de methodes vir- 
tuelles) conservent des informations sur leur type dynamique, a savoir leur veritable nature. En effet, 
lors de l'appel des methodes virtuelles, la methode appelee est la methode de la veritable classe de 
1' objet. 

II est possible d'utiliser cette propriete pour mettre en place un mecanisme permettant d'identifier le 
type dynamique des objets, mais cette maniere de proceder n'est pas portable. Le C++ fournit done 
un mecanisme standard permettant de manipuler les informations de type des objets polymorphiques. 
Ce mecanisme prend en charge V identification dynamique des types et la verification de la validite 
des transtypages dans le cadre de la derivation. 

10.1. Identification dynamique des types 
10.1.1. L'operateur typeid 

Le C++ fournit l'operateur typeid, qui permet de recuperer les informations de type des expressions. 
Sa syntaxe est la suivante : 

typeid (expression) 

ou expression est l'expression dont il faut determiner le type. 

Le resultat de l'operateur typeid est une reference sur un objet constant de classe type_info. Cette 
classe sera decrite dans la Section 10.1.2. 

Les informations de type recuperees sont les informations de type statique pour les types non poly- 
morphiques. Cela signifie que l'objet renvoye par typeid caracterisera le type de l'expression fournie 
en parametre, que cette expression soit un sous-objet d'un objet plus derive ou non. En revanche, pour 
les types polymorphiques, si le type ne peut pas etre determine statiquement (e'est-a-dire a la com- 
pilation), une determination dynamique (e'est-a-dire a l'execution) du type a lieu, et l'objet de classe 
type_info renvoye decrit le vrai type de l'expression (meme si elle represente un sous-objet d'un objet 
d'une classe derivee). Cette situation peut arriver lorsqu'on manipule un objet a l'aide d'un pointeur 
ou d'une reference sur une classe de base de la classe de cet objet. 

Exemple 10-1. Operateur typeid 

#include <typeinfo> 

using namespace std; 

class Base 

{ 

public : 

virtual -Base (void) ; // II faut une fonction virtuelle 

// pour avoir du polymorphisme . 

}; 
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Base: :~Base (void) 
{ 

return ; 

} 

class Derivee : public Base 

{ 

public : 

virtual -Derivee (void) ; 
}; 

Derivee: : -Derivee (void) 
{ 

return ; 
} 

int main (void) 
{ 

Derivee* pd = new Derivee; 

Base* pb = pd; 

const type_info St l=typeid ( *pd) ; // tl qualifie le type de *pd. 

const type_info St2=typeid ( *pb) ; // t2 qualifie le type de *pb. 

return ; 



Les objets tl et t2 sont egaux, puisqu'ils qualifiers tous les deux le meme type (a savoir, la classe 
Derivee). t2 ne contient pas les informations de type de la classe Base, parce que le vrai type de 
l'objet pointe par pb est la classe Derivee. 

Note : Notez que la classe type_info est definie dans I'espace de nommage std: :, reserve a la 
bibliotheque standard C++, dans I'en-tete typeinf o. Par consequent, son nom doit etre precede 
du prefixe std: : . Vous pouvez vous passer de ce prefixe en important les definitions de I'espace 
de nommage de la bibliotheque standard a I'aide d'une directive using. Vous trouverez de plus 
amples renseignements sur les espaces de nommage dans le Chapitre 1 1 . 



On fera bien attention a dereferencer les pointeurs, car sinon, on obtient les informations de type sur 
ce pointeur, pas sur l'objet pointe. Si le pointeur dereference est le pointeur nul, l'operateur typeid 
lance une exception dont l'objet est une instance de la classe bad_typeid. Cette classe est definie 
comme suit dans l'en-tete typeinf o : 

class bad_typeid : public logic 

{ 

public : 

bad_typeid (const char * what_arg) : logic (what_arg) 

{ 

return ; 

} 

void raise (void) 
{ 

handle_raise ( ) ; 

throw *this; 
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10.1.2. La classe type_info 

Les informations de type sont enregistrees dans des objets de la classe type_info predefinie par le 
langage. Cette classe est declaree dans l'en-tete typeinf o de la maniere suivante : 

class type_info 

{ 

public : 

virtual ~type_inf o ( ) ; 

bool operator== (const type_info &rhs) const; 

bool operator ! = (const type_info Srhs) const; 

bool before (const type_info &rhs) const; 

const char *name() const; 
private : 

type_info (const type_info Srhs) ; 

type_info &operator= (const type_info Srhs); 



Les objets de la classe type_info ne peuvent pas etre copies, puisque l'operateur d'affectation et le 
constructeur de copie sont tous les deux declares private. Par consequent, le seul moyen de generer 
un objet de la classe type_info est d'utiliser l'operateur typeid. 

Les operateurs de comparaison permettent de tester l'egalite et la difference de deux objets type_info, 
ce qui revient exactement a comparer les types des expressions. 

Les objets type_info contiennent des informations sur les types sous la forme de chaines de caracteres. 
Une de ces chaines represente le type sous une forme lisible par un etre humain, et une autre sous une 
forme plus appropriee pour le traitement des types. Le format de ces chaines de caracteres n'est pas 
precise et peut varier d'une implementation a une autre. II est possible de recuperer le nom lisible du 
type a l'aide de la methode name. La valeur renvoyee est un pointeur sur une chaine de caracteres. On 
ne doit pas liberer la memoire utilisee pour stocker cette chaine de caracteres. 

La methode before permet de determiner un ordre dans les differents types appartenant a la meme 
hierarchie de classes, en se basant sur les proprietes d'heritage. L'utilisation de cette methode est 
toutefois difficile, puisque l'ordre entre les differentes classes n'est pas fixe et peut dependre de 
1' implementation. 



10.2. Transtypages C++ 



Les regies de derivation permettent d'assurer le fait que lorsqu'on utilise un pointeur sur une classe, 
l'objet pointe existe bien et est bien de la classe sur laquelle le pointeur est base. En particulier, il est 
possible de convertir un pointeur sur un objet en un pointeur sur un sous-objet. 

En revanche, il est interdit d'utiliser un pointeur sur une classe de base pour initialiser un pointeur sur 
une classe derivee. Pourtant, cette operation peut etre legale, si le programmeur sait que le pointeur 
pointe bien sur un objet de la classe derivee. Le langage exige cependant un transtypage explicite. 
Une telle situation demande 1' analyse du programme afin de savoir si elle est legale ou non. 

Parfois, il est impossible de faire cette analyse. Cela signifie que le programmeur ne peut pas certifier 
que le pointeur dont il dispose est un pointeur sur un sous-objet. Le mecanisme d' identification dyna- 
mique des types peut etre alors utilise pour verifier, a l'execution, si le transtypage est legal. S'il ne 
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Test pas, un traitement particulier doit etre effectue, mais s'il Test, le programme peut se poursuivre 
normalement. 

Le C++ fournit un jeu d' operateurs de transtypage qui permettent de faire ces verifications dyna- 
miques, et qui done sont nettement plus surs que le transtypage tout puissant du C que Ton a utilise 
jusqu'ici. Ces operateurs sont capables de faire un transtypage dynamique, un transtypage statique, 
un transtypage de Constance et un transtypage de reinterpretation des donnees. Nous allons voir les 
differents operateurs permettant de faire ces transtypages, ainsi que leur signification. 

10.2.1. Transtypage dynamique 

Le transtypage dynamique permet de convertir une expression en un pointeur ou une reference d'une 
classe, ou un pointeur sur void. II est realise a 1'aide de l'operateur dynamic_cast. Cet operateur 
impose des restrictions lors des transtypages afin de garantir une plus grande fiabilite : 

• il effectue une verification de la validite du transtypage ; 

• il n'est pas possible d'eliminer les qualifications de Constance (pour cela, il faut utiliser l'operateur 
const_cast, que Ton verra plus loin). 



En revanche, l'operateur dynamic_cast permet parfaitement d'accroitre la Constance d'un type com- 
plexe, comme le font les conversions implicites du langage vues dans la Section 3.2 et dans la Section 
4.7. 

II ne peut pas travailler sur les types de base du langage, sauf void *. 

La syntaxe de l'operateur dynamic_cast est donnee ci-dessous : 

dynamic_cast<type> (expression) 

oil type designe le type cible du transtypage, et expression l'expression a transtyper. 

Le transtypage d'un pointeur ou d'une reference d'une classe derivee en classe de base se fait done 
directement, sans verification dynamique, puisque cette operation est toujours valide. Les lignes 
suivantes : 

// La classe B herite de la classe A : 

B *pb; 

A *pA=dynamic_cast<A *> (pB) ; 

sont done strictement equivalentes a celles-ci : 

// La classe B herite de la classe A : 

B *pb; 

A *pA=pB; 



Tout autre transtypage doit se faire a partir d'un type polymorphique, afin que le compilateur puisse 
utiliser 1' identification dynamique des types lors du transtypage. Le transtypage d'un pointeur d'un 
objet vers un pointeur de type void renvoie l'adresse du debut de l'objet le plus derive, e'est-a-dire 
l'adresse de l'objet complet. Le transtypage d'un pointeur ou d'une reference sur un sous-objet d'un 
objet vers un pointeur ou une reference de l'objet complet est effectue apres verification du type 
dynamique. Si l'objet pointe ou reference est bien du type indique pour le transtypage, l'operation 
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se deroule correctement. En revanche, s'il n'est pas du bon type, dynamic_cast n'effectue pas le 
transtypage. Si le type cible est un pointeur, le pointeur nul est renvoye. Si en revanche l'expression 
caracterise un objet ou une reference d'objet, une exception de type bad_cast est lancee. 

La classe bad_cast est definie comme suit dans l'en-tete typeinf o : 

class bad_cast : public exception 

{ 

public : 

bad_cast (void) throw (); 

bad_cast (const bad_cast&) throw () ; 

bad_cast &operator= (const bad_cast&) throw (); 

virtual ~bad_cast (void) throw (); 

virtual const char* what (void) const throw (); 

}; 



Lors d'un transtypage, aucune ambigui'te ne doit avoir lieu pendant la recherche dynamique du type. 
De telles ambigui'tes peuvent apparaitre dans les cas d'heritage multiple, ou plusieurs objets de meme 
type peuvent coexister dans le meme objet. Cette restriction mise a part, l'operateur dynamic_cast 
est capable de parcourir une hierarchie de classe aussi bien verticalement (convertir un pointeur de 
sous-objet vers un pointeur d'objet complet) que trans vers alement (convertir un pointeur d'objet vers 
un pointeur d'un autre objet frere dans la hierarchie de classes). 

L'operateur dynamic_cast peut etre utilise dans le but de convertir un pointeur sur une classe de 
base virtuelle vers une des ses classes filles, ce que ne pouvaient pas faire les transtypages classiques 
du C. En revanche, il ne peut pas etre utilise afin d'acceder a des classes de base qui ne sont pas 
visibles (en particulier, les classes de base heritees en private). 

Exemple 10-2. Operateur dynamic_cast 

struct A 
{ 

virtual void f (void) 

{ 

return ; 

} 
}; 

struct B : virtual public A 
{ 

}; 

struct C : virtual public A, public B 
{ 

}; 

struct D 
{ 

virtual void g(void) 

{ 

return ; 

} 

}; 

struct E : public B, public C, public D 
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}; 

int main (void) 
{ 

E e; // e contient deux sous-objets de classe B 
// (mais un seul sous-objet de classe A) . 
// Les sous-objets de classe C et D sont 
// f reres . 
A *pA=&e; // Derivation legale : le sous-objet 

// de classe A est unique. 
// C *pC=(C *) pA;// Illegal : A est une classe de base 
// virtuelle (erreur de compilation) . 
C *pC=dynamic_cast<C *> (pA) ; // Legal. Transtypage 

// dynamique vertical. 
D *pD=dynamic_cast<D *> (pC) ; // Legal. Transtypage 

// dynamique horizontal. 
B *pB=dynamic_cast<B *> (pA) ; // Legal, mais echouera 



// a 1' execution (ambiguite) 



return 



10.2.2. Transtypage statique 

Contrairement au transtypage dynamique, le transtypage statique n'effectue aucune verification des 
types dynamiques lors du transtypage. II est done nettement plus dangereux que le transtypage dyna- 
mique. Cependant, contrairement au transtypage C classique, il ne permet toujours pas de supprimer 
les qualifications de Constance. 

Le transtypage statique s'effectue a l'aide de l'operateur static_cast, dont la syntaxe est exacte- 
ment la meme que celle de l'operateur dynamic_cast : 

static_cast<type> (expression) 

oil type et expression ont la meme signification que pour l'operateur dynamic_cast. 

Essentiellement, l'operateur static_cast n'effectue l'operation de transtypage que si l'expression 
suivante est valide : 

type temporaire (expression) ; 



Cette expression construit un objet temporaire quelconque de type type et l'initialise avec la valeur 
de expression. Contrairement a l'operateur dynamic_cast, l'operateur static_cast permet done 
d'effectuer les conversions entre les types autres que les classes definies par 1'utilisateur. Aucune 
verification de la validite de la conversion n' a lieu cependant (comme pour le transtypage C classique). 

Si une telle expression n'est pas valide, le transtypage peut malgre tout avoir lieu s'il s'agit d'un 
transtypage entre classes derivees et classes de base. L'operateur static_cast permet d'effectuer 
les transtypages de ce type dans les deux sens (classe de base vers classe derivee et classe derivee 
vers classe de base). Le transtypage d'une classe de base vers une classe derivee ne doit etre fait 
que lorsqu'on est sur qu'il n'y a pas de danger, puisqu'aucune verification dynamique n'a lieu avec 
static cast. 
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Enfin, toutes les expressions peuvent etre converties en void avec des qualifications de Constance et 
de volatilite. Cette operation a simplement pour but de supprimer la valeur de l'expression (puisque 
void represente le type vide). 



10.2.3. Transtypage de Constance et de volatilite 

La suppression des attributs de Constance et de volatilite peut etre realisee grace a l'operateur 

const_cast. Cet operateur suit exactement la meme syntaxe que les operateurs dynamic_cast et 
static_cast : 

const_cast<type> (expression) 



L'operateur const_cast peut travailler essentiellement avec des references et des pointeurs. II per- 
met de realiser les transtypages dont le type destination est moins contraint que le type source vis-a-vis 
des mots cles const et volatile. 

En revanche, l'operateur const_cast ne permet pas d'effectuer d'autres conversions que les 
autres operateurs de transtypage (ou simplement les transtypages C classiques) peuvent realiser. 
Par exemple, il est impossible de l'utiliser pour convertir un flottant en entier. Lorsqu'il travaille 
avec des references, l'operateur const_cast verifie que le transtypage est legal en convertissant 
les references en pointeurs et en regardant si le transtypage n'implique que les attributs const et 
volatile. const_cast ne permet pas de convertir les pointeurs de fonctions. 



10.2.4. Reinterpretation des donnees 

L'operateur de transtypage le plus dangereux est reinterpret_cast. Sa syntaxe est la meme que 
celle des autres operateurs de transtypage dynamic_cast, static_cast et const_cast : 

reinterpret_cast<type> (expression) 



Cet operateur permet de reinterpreter les donnees d'un type en un autre type. Aucune verification de 
la validite de cette operation n'est faite. Ainsi, les lignes suivantes : 

double f=2 . 3; 

int i = l; 

const_cast<int &>(f)=i; 

sont strictement equivalentes aux lignes suivantes : 

double f=2 . 3; 

int i = l; 

* ( (int *) &f)=i; 



L'operateur reinterpret_cast doit cependant respecter les regies suivantes : 

• il ne doit pas permettre la suppression des attributs de Constance et de volatilite ; 

• il doit etre symetrique (c'est-a-dire que la reinterpretation d'un type Tl en tant que type T2, puis 
la reinterpretation du resultat en type Tl doit redonner l'objet initial). 
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Les espaces de nommage sont des zones de declaration qui permettent de delimiter la recherche des 
noms des identificateurs par le compilateur. Leur but est essentiellement de regrouper les identifi- 
cateurs logiquement et d'eviter les conflits de noms entre plusieurs parties d'un meme projet. Par 
exemple, si deux programmeurs definissent differemment une meme structure dans deux fichiers dif- 
ferents, un conflit entre ces deux structures aura lieu au mieux a l'edition de liens, et au pire lors de 
1' utilisation commune des sources de ces deux programmeurs. Ce type de conflit provient du fait que 
le C++ ne fournit qu'un seul espace de nommage de portee globale, dans lequel il ne doit y avoir 
aucun conflit de nom. Grace aux espaces de nommage non globaux, ce type de probleme peut etre 
plus facilement evite, parce que Ton peut eviter de definir les objets globaux dans la portee globale. 

11 .1 . Definition des espaces de nommage 
11.1.1. Espaces de nommage nominees 

Lorsque le programmeur donne un nom a un espace de nommage, celui-ci est appele un espace de 
nommage nomme. La syntaxe de ce type d' espace de nommage est la suivante : 

namespace nom 
{ 

declarations I definitions 
} 

nom est le nom de l'espace de nommage, et declarations et definitions sont les declarations et 
les definitions des identificateurs qui lui appartiennent. 

Contrairement aux regions declaratives classiques du langage (comme par exemple les classes), un 
namespace peut etre decoupe en plusieurs morceaux. Le premier morceaux sert de declaration, et les 
suivants d'extensions. La syntaxe pour une extension d'espace de nommage est exactement la meme 
que celle de la partie de declaration. 

Exemple 11-1. Extension de namespace 

namespace A // Declaration de l'espace de nommage A. 
int i; 



namespace B // Declaration de l'espace de nommage B. 
int i; 

namespace A // Extension de l'espace de nommage A. 

int j; 

Les identificateurs declares ou definis a l'interieur d'un meme espace de nommage ne doivent pas 
entrer en conflit. lis peuvent avoir les memes noms, mais seulement dans le cadre de la surcharge. Un 
espace de nommage se comporte done exactement comme les zones de declaration des classes et de 
la portee globale. 
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L'acces aux identificateurs des espaces de nommage se fait par defaut grace a l'operateur de resolution 
de portee ( : : ), et en qualifiant le nom de l'identificateur a utiliser du nom de son espace de nommage. 
Cependant, cette qualification est inutile a l'interieur de l'espace de nommage lui-meme, exactement 
comme pour les membres des classes a l'interieur de leur classe. 

Exemple 11-2. Acces aux membres d'un namespace 

int i=l; // i est global. 

namespace A 
{ 

int i=2; // i de l'espace de nommage A. 
int j=i; // Utilise A::i. 
} 

int main (void) 
{ 

i=l; // Utilise : :i. 

A: :i=3; // Utilise A: :i. 

return 0; 
} 

Les fonctions membres d'un espace de nommage peuvent etre definies a l'interieur de cet espace, 
exactement comme les fonctions membres de classes. Elles peuvent egalement etre definies en dehors 
de cet espace, si 1'on utilise l'operateur de resolution de portee. Les fonctions ainsi definies doivent 
apparaitre apres leur declaration dans l'espace de nommage. 

Exemple 11-3. Definition externe d'une fonction de namespace 

namespace A 
{ 

int f (void) ; // Declaration de A::f. 

} 

int A::f(void) // Definition de A::f. 
{ 

return 0; 
} 

II est possible de definir un espace de nommage a l'interieur d'un autre espace de nommage. Cepen- 
dant, cette declaration doit obligatoirement avoir lieu au niveau declaratif le plus externe de l'espace 
de nommage qui contient le sous-espace de nommage. On ne peut done pas declarer d' espaces de 
nommage a l'interieur d'une fonction ou a l'interieur d'une classe. 

Exemple 11-4. Definition de namespace dans un namespace 

namespace Conteneur 
{ 

int i; // Conteneur :: i . 

namespace Contenu 

{ 

int j; // Conteneur :: Contenu :: j . 
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11.1.2. Espaces de nommage anonymes 

Lorsque, lors de la declaration d'un espace de nommage, aucun nom n'est donne, un espace de nom- 
mage anonyme est cree. Ce type d'espace de nommage permet d'assurer l'unicite du nom de l'espace 
de nommage ainsi declare. Les espaces de nommage anonymes peuvent done remplacer efficacement 
le mot cle static pour rendre unique des identificateurs dans un fichier. Cependant, elles sont plus 
puissantes, parce que Ton peut egalement declarer des espaces de nommage anonymes a l'interieur 
d'autres espaces de nommage. 

Exemple 11-5. Definition de namespace anonyme 

namespace 
{ 

int i; // Equivalent a unique: :i; 



Dans 1' exemple precedent, la declaration de i se fait dans un espace de nommage dont le nom est 
choisi par le compilateur de maniere unique. Cependant, comme on ne connait pas ce nom, le com- 
pilateur utilise une directive using (voir plus loin) afin de pouvoir utiliser les identificateurs de cet 
espace de nommage anonyme sans preciser leur nom complet avec l'operateur de resolution de portee. 

Si, dans un espace de nommage, un identificateur est declare avec le meme nom qu'un autre identi- 
ficateur declare dans un espace de nommage plus global, 1' identificateur global est masque. De plus, 
1' identificateur ainsi defini ne peut etre accede en dehors de son espace de nommage que par un nom 
completement qualifie a l'aide de l'operateur de resolution de portee. Toutefois, si l'espace de nom- 
mage dans lequel il est defini est un espace de nommage anonyme, cet identificateur ne pourra pas 
etre reference, puisqu'on ne peut pas preciser le nom des espaces de nommage anonymes. 

Exemple 11-6. Ambiguites entre namespaces 

namespace 
{ 

int i; // Declare unique: :i. 

} 

void f (void) 
{ 

++i; // Utilise unique: :i. 

} 

namespace A 
{ 

namespace 

{ 

int i; // Definit A: : unique :: i . 
int j; // Definit A: : unique :: j . 
} 

void g (void) 
{ 

++i; // Erreur : ambiguite entre unique: :i 

// et A: :unique : : i . 

++A::i; // Erreur : A::i n'est pas defini 

// (seul A: :unique: :i l'est) . 

++j; // Correct : ++A: : unique :: j . 
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} 

11.1.3. Alias d'espaces de nommage 

Lorsqu'un espace de nommage porte un nom tres complique, il peut etre avantageux de definir un 
alias pour ce nom. L' alias aura alors un nom plus simple. 

Cette operation peut etre realisee a l'aide de la syntaxe suivante : 

namespace nom_alias = nom; 

nom_alias est ici le nom de Farias de l'espace de nommage, et nom est le nom de l'espace de 
nommage lui-meme. 

Les noms donnes aux alias d'espaces de nommage ne doivent pas entrer en conflit avec les noms des 
autres identificateurs du meme espace de nommage, que celui-ci soit l'espace de nommage de portee 
globale ou non. 



11.2. Declaration using 



Les declarations using permettent d'utiliser un identificateur d'un espace de nommage de maniere 
simplifiee, sans avoir a specifier son nom complet (c'est-a-dire le nom de l'espace de nommage suivi 
du nom de l'identificateur). 

11.2.1. Syntaxe des declarations using 

La syntaxe des declarations using est la suivante : 

using identificateur; 

ou identificateur est le nom complet de l'identificateur a utiliser, avec qualification d'espace de 
nommage. 

Exemple 11-7. Declaration using 



// Declare A: :i. 
// Declare A: : j . 



namespace 


A 


{ 


int i; 

int j; 




} 






voi 


d f (voi 


-d) 


{ 








using 


A: :i 




i=l; 






j=i; 






return ; 



// A::i peut etre utilise sous le nom i. 

// Equivalent a A::i=l. 

// Erreur ! j n'est pas defini ! 



} 



Les declarations using permettent en fait de declarer des alias des identificateurs. Ces alias doivent 
etre considered exactement comme des declarations normales. Cela signifie qu'ils ne peuvent etre 
declares plusieurs fois que lorsque les declarations multiples sont autorisees (declarations de variables 
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ou de fonctions en dehors des classes), et de plus ils appartiennent a l'espace de nommage dans lequel 
ils sont definis. 

Exemple 11-8. Declarations using multiples 



n 


amespace 


A 




{ 


int i 








void 


f (voi 


d) 




{ 







namespace B 
{ 

using A::i; // Declaration de l'alias B::i, qui represente A::i. 

using A::i; // Legal : double declaration de A::i. 

using A::f; // Declare void B::f(void), 

// fonction identique a A::f. 
} 

int main (void) 
{ 

B: :f () ; // Appelle A: :f . 

return 0; 
} 

L'alias cree par une declaration using permet de referencer uniquement les identificateurs qui sont 
visibles au moment ou la declaration using est faite. Si l'espace de nommage concerne par la decla- 
ration using est etendu apres cette derniere, les nouveaux identificateurs de meme nom que celui de 
l'alias ne seront pas pris en compte. 

Exemple 11-9. Extension de namespace apres une declaration using 

namespace A 
{ 

void f (int ) ; 



using A: :f; // f est synonyme de A: : f (int ) . 

namespace A 
{ 

void f(char); // f est toujours synonyme de A::f(int), 
// mais pas de A: :f (char) . 
} 

void g() 
{ 

f('a'); // Appelle A::f(int), meme si A::f(char) 

// existe. 



} 

Si plusieurs declarations locales et using declarent des identificateurs de meme nom, ou bien ces 
identificateurs doivent tous se rapporter au meme objet, ou bien ils doivent representer des fonctions 
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ayant des signatures differentes (les fonctions declarees sont done surchargees). Dans le cas contraire, 
des ambigui'tes peuvent apparaitre et le compilateur signale une erreur lors de la declaration using. 

Exemple 11-10. Conflit entre declarations using et identificateurs locaux 

namespace A 
{ 

int i; 

void f (int) ; 
} 

void g(void) 
{ 

int i; // Declaration locale de i. 

using A::i; // Erreur : i est deja declare. 

void f(char); // Declaration locale de f(char). 

using A::f; // Pas d' erreur, il y a surcharge de f. 

return ; 



Note : Ce comportement differe de celui des directives using. En effet, les directives using 
reportent la detection des erreurs a la premiere utilisation des identificateurs ambigus. 



11.2.2. Utilisation des declarations using dans les classes 

Une declaration using peut etre utilisee dans la definition d'une classe. Dans ce cas, elle doit se 
rapporter a une classe de base de la classe dans laquelle elle est utilisee. De plus, l'identificateur donne 
a la declaration using doit etre accessible dans la classe de base (e'est-a-dire de type protected ou 
public). 

Exemple 11-11. Declaration using dans une classe 

namespace A 
{ 

float f; 
} 

class Base 
{ 

int i; 

public : 

int j; 



class Derivee : public Base 
{ 

using A::f; // Illegal : f n'est pas dans une classe 

// de base, 
using Base::i; // Interdit : Derivee n' a pas le droit 

// d'utiliser Base : : i . 
public : 

using Base::j; // Legal. 

}; 
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Dans l'exemple precedent, seule la troisieme declaration est valide, parce que c'est la seule qui se 
refere a un membre accessible de la classe de base. Le membre j declare sera done un synonyme de 
Base : : j dans la classe Derivee. 

En general, les membres des classes de base sont accessibles directement. Quelle est done l'utilite 
des declarations using dans les classes ? En fait, elles peuvent etre utilisees pour retablir les droits 
d'acces, modifies par un heritage, a des membres de classes de base. Pour cela, il suffit de placer la 
declaration using dans une zone de declaration du meme type que celle dans laquelle le membre se 
trouvait dans la classe de base. Cependant, comme on l'a vu ci-dessus, une classe ne peut pas retablir 
les droits d'acces d'un membre de classe de base declare en zone private. 

Exemple 11-12. Retablissement de droits d'acces a l'aide d'une directive using 



cl 


ass Base 


{ 






pu 


blic : 






int 


i; 




int 


j; 


}; 







class Derivee : private Base 

{ 

public : 

using Base::i; // Retablit 1' accessibility sur Base : : i . 
protected: 

using Base::i; // Interdit : restreint 1' accessibility 

// sur Base::i autrement que par heritage. 

}; 



Note : Certains compilateurs interpretent differemment le paragraphe 1 1 .3 de la norme C++, qui 
concerne I'accessibilite des membres introduits avec une declaration using. Selon eux, les dec- 
larations using permettent de restreindre I'accessibilite des droits et non pas de les retablir. Cela 
implique qu'il est impossible de redonner I'accessibilite a des donnees pour lesquelles I'heritage 
a restreint I'acces. Par consequent, I'heritage doit etre fait de la maniere la plus permissive pos- 
sible, et les acces doivent etre ajustes au cas par cas. Bien que cette interpretation soit tout a fait 
valable, l'exemple donne dans la norme C++ semble indiquer qu'elle n'est pas correcte. 



Quand une fonction d'une classe de base est introduite dans une classe derivee a l'aide d'une declara- 
tion using, et qu'une fonction de meme nom et de meme signature est definie dans la classe derivee, 
cette derniere fonction surcharge la fonction de la classe de base. II n'y a pas d'ambiguite dans ce cas. 



11.3. Directive using 

La directive using permet d'utiliser, sans specification d'espace de nommage, non pas un identificateur 
comme dans le cas de la declaration using, mais tous les identificateurs de cet espace de nommage. 

La syntaxe de la directive using est la suivante : 

using namespace nom; 

ou nom est le nom de l'espace de nommage dont les identificateurs doivent etre utilises sans qualifi- 
cation complete. 
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Exemple 11-13. Directive using 

namespace A 



int i; 


// Declare A: 


: i . 


int j ; 


// Declare A: 


: j • 


} 






void f (void) 







using namespace A; // On utilise les identif icateurs de A. 
i=l; // Equivalent a A::i=l. 

j=l; // Equivalent a A::j=l. 

return ; 



} 



Apres une directive using, il est toujours possible d'utiliser les noms complets des identificateurs de 
l'espace de nommage, mais ce n'est plus necessaire. Les directives using sont valides a partir de la 
ligne ou elles sont declarees jusqu'a la fin du bloc de portee courante. Si un espace de nommage est 
etendu apres une directive using, les identificateurs definis dans l'extension de l'espace de nommage 
peuvent etre utilises exactement comme les identificateurs definis avant la directive using (c'est-a- 
dire sans qualification complete de leurs noms). 

Exemple 11-14. Extension de namespace apres une directive using 

namespace A 
{ 

int i; 
} 

using namespace A; 

namespace A 
{ 

int j; 
} 

void f (void) 
{ 

i=0; // Initialise A::i. 

j=0; // Initialise A::j. 

return ; 
} 

II se peut que lors de 1' introduction des identificateurs d'un espace de nommage par une directive 
using, des conflits de noms apparaissent. Dans ce cas, aucune erreur n'est signalee lors de la directive 
using. En revanche, une erreur se produit si un des identificateurs pour lesquels il y a conflit est 
utilise. 

Exemple 11-15. Conflit entre directive using et identificateurs locaux 

namespace A 
{ 

int i; // Definit A::i. 
} 



776 



Chapitre 11. Les espaces de nommage 



namespace B 
{ 

int i; // Definit B::i. 

using namespace A; // A::i et B::i sont en conf lit . 

// Cependant, aucune erreur n'apparait. 
} 

void f (void) 
{ 

using namespace B; 

i=2; // Erreur : il y a ambiguite. 

return ; 
} 
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12.1. Generalites 



Nous avons vu precedemment comment realiser des structures de donnees relativement independantes 
de la classe de leurs donnees (c'est-a-dire de leur type) avec les classes abstraites. Par ailleurs, il est 
faisable de faire des fonctions travaillant sur de nombreux types grace a la surcharge. Je rappelle qu'en 
C++, tous les types sont en fait des classes. 

Cependant, l'emploi des classes abstraites est assez fastidieux et a 1' inconvenient d'affaiblir le 
controle des types realise par le compilateur. De plus, la surcharge n'est pas generalisable pour tous 
les types de donnees. II serait possible d'utiliser des macros pour faire des fonctions atypiques mais 
cela serait au detriment de la taille du code. 

Le C++ permet de resoudre ces problemes grace aux parametres generiques, que l'on appelle en- 
core parametres template. Un parametre template est soit un type generique, soit une constante 
dont le type est assimilable a un type integral. Comme leur nom l'indique, les parametres template 
permettent de parameter la definition des fonctions et des classes. Les fonctions et les classes ainsi 
parameters sont appelees respectivement fonctions template et classes template. 

Les fonctions template sont done des fonctions qui peuvent travailler sur des objets dont le type est un 
type generique (c'est-a-dire un type quelconque), ou qui peuvent etres parametres par une constante 
de type integral. Les classes template sont des classes qui contiennent des membres dont le type est 
generique ou qui dependent d'un parametre integral. 

En general, la generation du code a lieu lors d'une operation au cours de laquelle les types gene- 
riques sont remplaces par des vrais types et les parametres de type integral prennent leur valeur. Cette 
operation s'appelle V instanciation des template. Elle a lieu lorsqu'on utilise la fonction ou la classe 
template pour la premiere fois. Les types reels a utiliser a la place des types generiques sont de- 
termines lors de cette premiere utilisation par le compilateur, soit implicitement a partir du contexte 
d'utilisation du template, soit par les parametres donnes explicitement par le programmeur. 



12.2. Declaration des parametres template 



Les parametres template sont, comme on Fa vu, soit des types generiques, soit des constantes dont 
le type peut etre assimile a un type integral. 

12.2.1. Declaration des types template 

Les template qui sont des types generiques sont declares par la syntaxe suivante : 

template <class | typename nom[=type] 

[, class I typename nom[=type] 
[...]> 

ou nom est le nom que l'on donne au type generique dans cette declaration. Le mot cle class a ici 
exactement la signification de « type ». II peut d' ailleurs etre remplace indifferemment dans cette 
syntaxe par le mot cle typename. La meme declaration peut etre utilisee pour declarer un nombre 
arbitraire de types generiques, en les separant par des virgules. Les parametres template qui sont 
des types peuvent prendre des valeurs par defaut, en faisant suivre le nom du parametre d'un signe 
egal et de la valeur. Ici, la valeur par defaut doit evidemment etre un type deja declare. 
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Exemple 12-1. Declaration de parametres template 

template <class T, typename U, class V=int> 

Dans cet exemple, T, U et V sont des types generiques. lis peuvent remplacer n'importe quel type du 
langage deja declare au moment ou la declaration template est faite. De plus, le type generique V a 
pour valeur par defaut le type entier int. On voit bien dans cet exemple que les mots cles typename 
et class peuvent etre utilises indifferemment. 

Lorsqu'on donne des valeurs par defaut a un type generique, on doit donner des valeurs par defaut a 
tous les types generiques qui le suivent dans la declaration template. La ligne suivante provoquera 
done une erreur de compilation : 

template <class T=int, class V> 



II est possible d'utiliser une classe template en tant que type generique. Dans ce cas, la classe doit 
etre declaree comme etant template a l'interieur meme de la declaration template. La syntaxe est 
done la suivante : 

template <template <class Type> class Classe [,...]> 

ou Type est le type generique utilise dans la declaration de la classe template Classe. On appelle 
les parametres template qui sont des classes template des parametres template template. Rien 
n'interdit de donner une valeur par defaut a un parametre template template : le type utilise doit 
alors etre une classe template declaree avant la declaration template. 

Exemple 12-2. Declaration de parametre template template 

template <class T> 

class Tableau 

{ 

// Definition de la classe template Tableau. 

}; 

template <class U, class V, template <class T> class C=Tableau> 

class Dictionnaire 

{ 

C<U> Clef; 

C<V> Valeur; 

// Reste de la definition de la classe Dictionnaire. 
}; 

Dans cet exemple, la classe template Dictionnaire permet de relier des cles a leurs elements. Ces cles 
et ces valeurs peuvent prendre n'importe quel type. Les cles et les valeurs sont stockees parallelement 
dans les membres Clef et Valeur. Ces membres sont en fait des conteneurs template, dont la 
classe est generique et designee par le parametre template template C. Le parametre template 
de C est utilise pour donner le type des donnees stockees, a savoir les types generiques U et V dans 
le cas de la classe Dictionnaire. Enfin, la classe Dictionnaire peut utiliser un conteneur par defaut, qui 
est la classe template Tableau. 

Pour plus de details sur la declaration des classes template, voir la Section 12.3.2. 
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12.2.2. Declaration des constantes template 

La declaration des parametres template de type constante se fait de la maniere suivante : 

template <type parametre [=valeur] [, ...]> 

ou type est le type du parametre constant, parametre est le nom du parametre et valeur est sa 
valeur par defaut. II est possible de donner des parametres template qui sont des types generiques 
et des parametres template qui sont des constantes dans la meme declaration. 

Le type des constantes template doit obligatoirement etre l'un des types suivants : 

• type integral (char, wchar_t, int, long, short et leurs versions signees et non signees) ou enumere ; 

• pointeur ou reference d'objet ; 

• pointeur ou reference de fonction ; 

• pointeur sur membre. 

Ce sont done tous les types qui peuvent etre assimiles a des valeurs entieres (entiers, enumeres ou 
adresses). 

Exemple 12-3. Declaration de parametres template de type constante 

template <class T, int i, void (*f) (int)> 

Cette declaration template comprend un type generique T, une constante template i de type int, 
et une constante template f de type pointeur sur fonction prenant un entier en parametre et ne 
renvoyant rien. 

Note : Les parametres constants de type reference ne peuvent pas etre initialises avec une 
donnee immediate ou une donnee temporaire lors de I'instanciation du template. Voir la Section 
12.4 pour plus de details sur I'instanciation des template. 



12.3. Fonctions et classes template 

Apres la declaration d'un ou de plusieurs parametres template suit en general la declaration ou 
la definition d'une fonction ou d'une classe template. Dans cette definition, les types generiques 
peuvent etre utilises exactement comme s'il s'agissait de types normaux. Les constantes template 
peuvent etre utilisees dans la fonction ou la classe template comme des constantes locales. 

12.3.1. Fonctions template 

La declaration et la definition des fonctions template se fait exactement comme si la fonction etait 
une fonction normale, a ceci pres qu'elle doit etre precedee de la declaration des parametres tem- 
plate. La syntaxe d'une declaration de fonction template est done la suivante : 

template <parametres_template> 
type fonction (parametres_f onction) ; 
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oil parametre_template est la liste des parametres template et parametres_f onction est la 
liste des parametres de la fonction fonction. type est le type de la valeur de retour de la fonction, 
ce peut etre un des types generiques de la liste des parametres template. 

Tous les parametres template qui sont des types doivent etre utilises dans la liste des parametres de 
la fonction, a moins qu'une instanciation explicite de la fonction ne soit utilisee. Cela permet au com- 
pilateur de realiser 1' identification des types generiques avec les types a utiliser lors de l'instanciation 
de la fonction. Voir la Section 12.4 pour plus de details a ce sujet. 

La definition d'une fonction template se fait comme une declaration avec le corps de la fonction. 
II est alors possible d'y utiliser les parametres template comme s'ils etaient des types normaux : 
des variables peuvent etre declarees avec un type generique, et les constantes template peuvent etre 
utilisees comme des variables definies localement avec la classe de stockage const. Les fonctions 
template s'ecrivent done exactement comme des fonctions classiques. 

Exemple 12-4. Definition de fonction template 

template <class T> 
T Min (T x, T y) 
{ 

return x<y ? x : y; 
} 

La fonction Min ainsi definie fonctionnera parfaitement pour toute classe pour laquelle l'operateur < 
est defini. Le compilateur determinera automatiquement quel est l'operateur a employer pour chaque 
fonction Min qu'il rencontrera. 

Les fonctions template peuvent etre surchargees, aussi bien par des fonctions classiques que par 
d'autres fonctions template. Lorsqu'il y a ambiguite entre une fonction template et une fonction 
normale qui la surcharge, toutes les references sur le nom commun a ces fonctions se rapporteront a 
la fonction classique. 

Une fonction template peut etre declaree amie d'une classe, template ou non, pourvu que cette 
classe ne soit pas locale. Toutes les instances generees a partir d'une fonction amie template sont 
amies de la classe donnant l'amitie, et ont done libre acces sur toutes les donnees de cette classe. 



12.3.2. Les classes template 

La declaration et la definition d'une classe template se font comme celles d'une fonction 
template : elles doivent etre precedees de la declaration template des types generiques. La 
declaration suit done la syntaxe suivante : 

template <parametres_template> 
class I struct I union nom; 

ou parametres_template est la liste des parametres template utilises par la classe template 

nom. 

La seule particularite dans la definition des classes template est que si les methodes de la classe ne 
sont pas definies dans la declaration de la classe, elles devront elles aussi etre declarees template : 

template <parametres_template> 

type classe<parametres> : :nom (parametres_methode) 

{ 
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oil parametre_template represente la liste des parametres template de la classe template 
classe, nom represente le nom de la methode a definir, et parametres_methode ses parametres. 

II est absolument necessaire dans ce cas de specifier tous les parametres template de la liste pa- 
rametres_template dans parametres, separes par des virgules, afin de caracteriser le fait que c'est 
la classe classe qui est template et qu'il ne s'agit pas d'une methode template d'une classe 
normale. D'une maniere generale, il faudra toujours specifier les types generiques de la classe entre 
les signes d'inferiorite et de superiorite, juste apres son nom, a chaque fois qu'on voudra la referen- 
ces Cette regie est cependant facultative lorsque la classe est referencee a 1'interieur d'une fonction 
membre. 

Contrairement aux fonctions template non membres, les methodes des classes template peuvent 
utiliser des types generiques de leur classe sans pour autant qu'ils soient utilises dans la liste de leurs 
parametres. En effet, le compilateur determine quels sont les types a identifier aux types generiques 
lors de l'instanciation de la classe template, et n'a done pas besoin d'effectuer cette identification 
avec les types des parametres utilises. Voir la Section 12.3.3 pour plus de details a ce sujet. 

Exemple 12-5. Definition d'une pile template 

template <class T> 

class Stack 

{ 

typedef struct stackitem 
{ 

T Item; // On utilise le type T comme 

struct stackitem *Next; // si e'etait un type normal. 
} Stackitem; 

Stackitem *Tete; 

public: // Les fonctions de la pile : 

Stack (void) ; 
Stack (const Stack<T> &); 

// La classe est referencee en indiquant 

// son type entre < et > ("Stack<T>") . 

// Ici, ce n' est pas une necessite 

// cependant. 
-Stack (void) ; 

Stack<T> &operator= (const Stack<T> &); 
void push (T) ; 
T pop (void) ; 

bool is_empty (void) const; 
void flush (void); 



// Pour les fonctions membres definies en dehors de la declaration 
// de la classe, il faut une declaration de type generique : 

template <class T> 

Stack<T> :: Stack (void) // La classe est referencee en indiquant 

// son type entre < et > ( "Stack<T>" ) . 
// C'est imperatif en dehors de la 
// declaration de la classe. 
{ 

Tete = NULL; 
return; 
} 
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template <class T> 

Stack<T> : :Stack (const Stack<T> Slnit) 

{ 

Tete = NULL; 

Stackltem *tmpl = Init.Tete, *tmp2 = NULL; 

while (tmpl!=NULL) 

{ 

if (tmp2==NULL) 

{ 

Tete= new Stackltem; 
tmp2 = Tete; 
} 

else 
{ 

tmp2->Next = new Stackltem; 
tmp2 = tmp2->Next; 
} 

tmp2->Item = tmpl->Item; 
tmpl = tmpl->Next; 
} 

if (tmp2!=NULL) tmp2->Next = NULL; 
return; 
} 

template <class T> 
Stack<T> : : -Stack (void) 
{ 

flushO ; 

return; 



template <class T> 

Stack<T> SStack<T>: :operator= (const Stack<T> Slnit) 

{ 

flush() ; 

Stackltem *tmpl = Init.Tete, *tmp2 = NULL; 

while (tmpl!=NULL) 

{ 

if (tmp2==NULL) 

{ 

Tete = new Stackltem; 
tmp2 = Tete; 
} 

else 
{ 

tmp2->Next = new Stackltem; 
tmp2 = tmp2->Next; 
} 

tmp2->Item = tmpl->Item; 
tmpl = tmpl->Next; 
} 

if (tmp2!=NULL) tmp2->Next = NULL; 
return *this; 
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template <class T> 

void Stack<T>: :push (T Item) 

{ 

Stackltem *tmp = new Stackltem; 

tmp->Item = Item; 

tmp->Next = Tete; 

Tete = tmp; 

return; 
} 

template <class T> 
T Stack<T>: :pop (void) 
{ 

T tmp; 

Stackltem *ptmp = Tete; 

if (Tete!=NULL) 
{ 

tmp = Tete->Item; 

Tete = Tete->Next; 

delete ptmp; 



return tmp; 



} 



template <class T> 

bool Stack<T> : : is_empty (void) const 



return (Tete==NULL) ; 



} 



template <class T> 

void Stack<T>: : flush (void) 

{ 

while (Tete!=NULL) pop ( ) ; 

return; 



Les classes template peuvent parfaitement avoir des fonctions amies, que ces fonctions soient elles- 
memes template ou non. 



12.3.3. Fonctions membres template 

Les destructeurs mis a part, les methodes d'une classe peuvent etre template, que la classe elle- 
meme soit template ou non, pourvu que la classe ne soit pas une classe locale. 

Les fonctions membres template peuvent appartenir a une classe template ou a une classe nor- 
male. 

Lorsque la classe a laquelle elles appartiennent n'est pas template, leur syntaxe est exactement la 
meme que pour les fonctions template non membre. 



755 



Chapitre 12. Les template 

Exemple 12-6. Fonction membre template 

class A 
{ 

int i; // Valeur de la classe. 
public : 

template <class T> 

void add(T valeur); 

}; 

template <class T> 
void A::add(T valeur) 
{ 

i=i+((int) valeur); // Ajoute valeur a A::i. 

return ; 
} 

Si, en revanche, la classe dont la fonction membre fait partie est elle aussi template, il faut spe- 
cifier deux fois la syntaxe template : une fois pour la classe, et une fois pour la fonction. Si la 
fonction membre template est definie a l'interieur de la classe, il n'est pas necessaire de donner 
les parametres template de la classe, et la definition de la fonction membre template se fait done 
exactement comme celle d'une fonction template classique. 

Exemple 12-7. Fonction membre template d'une classe template 

template<class T> 
class Chaine 
{ 
public : 

// Fonction membre template definie 

// a l'exterieur de la classe template : 

template<class T2> int compare (const T2 &); 

// Fonction membre template definie 

// a l'interieur de la classe template : 

template<class T2> 

Chaine (const Chaine<T2> &s) 

{ 

// . . . 



// A l'exterieur de la classe template, on doit donner 
// les declarations template pour la classe 
// et pour la fonction membre template : 

template<class T> template<class T2> 
int Chaine<T> :: compare (const T2 &s) 
{ 

// . . . 
} 

Les fonctions membres virtuelles ne peuvent pas etre template. Si une fonction membre template 
a le meme nom qu'une fonction membre virtuelle d'une classe de base, elle ne constitue pas une 
redefinition de cette fonction. Par consequent, les mecanismes de virtualite sont inutilisables avec les 
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fonctions membres template. On peut contourner ce probleme de la maniere suivante : on definira 
une fonction membre virtuelle non template qui appellera la fonction membre template. 

Exemple 12-8. Fonction membre template et fonction membre virtuelle 

class B 
{ 

virtual void f(int); 



class D : public B 
{ 

template <class T> 

void f(T); // Cette fonction ne redefinit pas B::f(int) 

void f(int i) // Cette fonction surcharge B::f(int). 
{ 

f<> (i) ; // Elle appelle de la fonction template. 

return ; 



Dans 1' exemple precedent, on est oblige de preciser que la fonction a appeler dans la fonction virtuelle 
est la fonction template, et qu'il ne s'agit done pas d'un appel recursif de la fonction virtuelle. Pour 
cela, on fait suivre le nom de la fonction template d'une paire de signes inferieur et superieur. 

Plus generalement, si une fonction membre template d'une classe peut etre specialised en une fonc- 
tion qui a la meme signature qu'une autre fonction membre de la meme classe, et que ces deux fonc- 
tions ont le meme nom, toute reference a ce nom utilisera la fonction non-template. II est possible 
de passer outre cette regie, a condition de donner explicitement la liste des parametres template 
entre les signes inferieur et superieur lors de 1' appel de la fonction. 

Exemple 12-9. Surcharge de fonction membre par une fonction membre template 

#include <iostream> 

using namespace std; 

struct A 
{ 

void f (int) ; 

template <class T> 

void f(T) 

{ 

cout << "Template" << endl; 
} 
}; 

// Fonction non template : 

void A: : f (int) 

{ 

cout << "Non template" << endl; 
} 

// Fonction template : 
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template <> 

void A: : f <int> (int) 

{ 

cout << "Specialisation f<int>" << endl; 
} 

int main (void) 
{ 

A a; 

a.f(l); // Appel de la version non-template de f. 

a.f('c'); // Appel de la version template de f. 

a.fO(l); // Appel de la version template specialisee de f. 

return 0; 



Pour plus de details sur la specialisation des template, voir la Section 12.5. 



12.4. Instanciation des template 



La definition des fonctions et des classes template ne genere aucun code tant que tous les parametres 
template n'ont pas pris chacun une valeur specifique. II faut done, lors de l'utilisation d'une fonction 
ou d'une classe template, fournir les valeurs pour tous les parametres qui n'ont pas de valeur par 
defaut. Lorsque suffisamment de valeurs sont donnees, le code est genere pour ce jeu de valeurs. On 
appelle cette operation V instanciation des template. 

Plusieurs possibilites sont offertes pour parvenir a ce resultat : V instanciation implicite et 
V instanciation explicite. 

12.4.1. Instanciation implicite 

L instanciation implicite est utilisee par le compilateur lorsqu'il rencontre une expression qui utilise 
pour la premiere fois une fonction ou une classe template, et qu'il doit l'instancier pour continuer 
son travail. Le compilateur se base alors sur le contexte courant pour determiner les types des para- 
metres template a utiliser. Si aucune ambiguite n'a lieu, il genere le code pour ce jeu de parametres. 

La determination des types des parametres template peut se faire simplement, ou etre deduite de 
1' expression a compiler. Par exemple, les fonctions membres template sont instanciees en fonction 
du type de leurs parametres. Si Ton reprend l'exemple de la fonction template Min definie dans 
l'Exemple 12-4, e'est son utilisation directe qui provoque une instanciation implicite. 

Exemple 12-10. Instanciation implicite de fonction template 

int i=Min (2,3); 

Dans cet exemple, la fonction Min est appelee avec les parametres 2 et 3. Comme ces entiers sont 
tous les deux de type int, la fonction template Min est instanciee pour le type int. Partout dans la 
definition de Min, le type generique T est done remplace par le type int. 

Si Ton appelle une fonction template avec un jeu de parametres qui provoque une ambiguite, le 
compilateur signale une erreur. Cette erreur peut etre levee en surchargeant la fonction template par 
une fonction qui accepte les memes parametres. Par example, la fonction template Min ne peut pas 
etre instanciee dans le code suivant : 
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int i=Min (2,3.0); 

parce que le compilateur ne peut pas determiner si le type generique T doit prendre la valeur int ou 
double. II y a done une erreur, sauf si une fonction Min (int, double) est definie quelque part. 
Pour resoudre ce type de probleme, on devra specifier manuellement les parametres template de la 
fonction, lors de l'appel. Ainsi, la ligne precedente compile si on la reecrit comme suit : 

int i=Min<int> (2, 3 . 0) ; 

dans cet exemple, le parametre template est force a int, et 3 . est converti en entier. 

On prendra garde au fait que le compilateur utilise une politique minimaliste pour l'instanciation im- 
plicite des template. Cela signifie qu'il ne creera que le code necessaire pour compiler l'expression 
qui exige une instanciation implicite. Par exemple, la definition d'un objet d'une classe template 
dont tous les types definis provoque l'instanciation de cette classe, mais la definition d'un poin- 
teur sur cette classe ne le fait pas. L'instanciation aura lieu lorsqu'un dereferencement sera fait par 
1' intermediate de ce pointeur. De meme, seules les fonctionnalites utilisees de la classe template 
seront effectivement definies dans le programme final. 

Par exemple, dans le programme suivant : 

#include <iostream> 

using namespace std; 

template <class T> 
class A 
{ 
public : 

void f (void) ; 

void g (void) ; 

}; 

// Definition de la methode A<T>::f() : 
template <class T> 
void A<T>: : f (void) 
{ 

cout << "A<T>::f() appelee" << endl; 
} 

// On ne definit pas la methode A<T> : :g() . . . 

int main (void) 
{ 

A<char> a; // Instanciation de A<char>. 

a.f(); // Instanciation de A<char> : : f ( ) . 

return 0; 
} 

seule la methode f de la classe template A est instanciee, car e'est la seule methode utilisee a cet 
endroit. Ce programme pourra done parfaitement etre compile, meme si la methode g n'a pas ete 
definie. 
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12.4.2. Instanciation explicite 

L'instanciation explicite des template est une technique permettant au programmeur de forcer 
1' instanciation des template dans son programme. Pour realiser une instanciation explicite, il faut 
specifier explicitement tous les parametres template a utiliser. Cela se fait simplement en donnant 
la declaration du template, precedee par le mot cle template : 

template nom<valeur [, valeur [...]] >; 



Par exemple, pour forcer l'instanciation d'une pile telle que celle definie dans l'Exemple 12-5, il 
faudra preciser le type des elements entre crochets apres le nom de la classe : 

template Stack<int>; // Instancie la classe Stack<int>. 



Cette syntaxe peut etre simplifiee pour les fonctions template, a condition que tous les parametres 
template puissent etre deduits par le compilateur des types des parametres utilises dans la declara- 
tion de la fonction. Ainsi, il est possible de forcer l'instanciation de la fonction template Min de la 
maniere suivante : 

template int Min(int, int); 



Dans cet exemple, la fonction template Min est instanciee pour le type int, puisque ses parametres 
sont de ce type. 

Lorsqu' une fonction ou une classe template a des valeurs par defaut pour ses parametres template, 
il n'est pas necessaire de donner une valeur pour ces parametres. Si toutes les valeurs par defaut sont 
utilisees, la liste des valeurs peut etre vide (mais les signes d'inferiorite et de superiorite doivent 
malgre tout etre presents). 

Exemple 12-11. Instanciation explicite de classe template 

template<class T = char> 
class Chaine; 

template ChaineO; // Instanciation explicite de Chaine<char> . 



12.4.3. Problemes souleves par l'instanciation des template 

Les template doivent imperativement etre definis lors de leur instanciation pour que le compila- 
teur puisse generer le code de l'instance. Cela signifie que les fichiers d'en-tete doivent contenir non 
seulement la declaration, mais egalement la definition complete des template. Cela a plusieurs in- 
convenients. Le premier est bien entendu que Ton ne peut pas considerer les template comme les 
fonctions et les classes normales du langage, pour lesquels il est possible de separer la declaration de 
la definition dans des fichiers separes. Le deuxieme inconvenient est que les instances des template 
sont compilees plusieurs fois, ce qui diminue d'autant plus les performances des compilateurs. Enfin, 
ce qui est le plus grave, c'est que les instances des template sont en multiples exemplaires dans les 
fichiers objets generes par le compilateur, et accroissent done la taille des fichiers executables a Tissue 
de l'edition de liens. Cela n'est pas genant pour les petits programmes, mais peut devenir redhibitoire 
pour les programmes assez gros. 



190 



Chapitre 12. Les template 

Le premier probleme n'est pas trop genant, car il reduit le nombre de fichiers sources, ce qui n'est en 
general pas une mauvaise chose. Notez egalement que les template ne peuvent pas etre considered 
comme des fichiers sources classiques, puisque sans instanciation, ils ne generent aucun code machine 
(ce sont des classes de classes, ou « metaclasses »). Mais ce probleme peut devenir ennuyant dans 
le cas de bibliotheques template ecrites et vendues par des societes desireuses de conserver leur 
savoir-faire. Pour resoudre ce probleme, le langage donne la possibilite d'exporter les definitions des 
template dans des fichiers complementaires. Nous verrons la maniere de proceder dans la Section 
12.7. 

Le deuxieme probleme peut etre resolu avec l'exportation des template, ou par tout autre technique 
d' optimisation des compilateurs. Actuellement, la plupart des compilateurs sont capables de generer 
des fichiers d'en-tete precompiles, qui contiennent le resultat de l'analyse des fichiers d'en-tete deja 
lus. Cette technique permet de diminuer considerablement les temps de compilation, mais necessite 
souvent d'utiliser toujours le meme fichier d'en-tete au debut des fichiers sources. 

Le troisieme probleme est en general resolu par des techniques variees, qui necessitent des traitements 
complexes dans l'editeur de liens ou le compilateur. La technique la plus simple, utilisee par la plupart 
des compilateurs actuels, passe par une modification de l'editeur de liens pour qu'il regroupe les 
differentes instances des memes template. D'autres compilateurs, plus rares, gerent une base de 
donnees dans laquelle les instances de template generees lors de la compilation sont stockees. Lors 
de 1' edition de liens, les instances de cette base sont ajoutees a la ligne de commande de l'editeur de 
liens afin de resoudre les symboles non definis. Enfin, certains compilateurs permettent de desactiver 
les instanciations implicites des template. Cela permet de laisser au programmeur la responsabilite 
de les instancier manuellement, a l'aide d' instanciations explicites. Ainsi, les template peuvent 
n'etre definies que dans un seul fichier source, reserve a cet effet. Cette derniere solution est de loin 
la plus sure, et il est done recommande d'ecrire un tel fichier pour chaque programme. 

Ce paragraphe vous a presente trois des principaux problemes souleves par 1' utilisation des tem- 
plate, ainsi que les solutions les plus courantes qui y ont ete apportees. II est vivement recommande 
de consulter la documentation fournie avec 1'environnement de developpement utilise, afin a la fois 
de reduire les temps de compilation et d'optimiser les executables generes. 



12.5. Specialisation des template 



Jusqu'a present, nous avons defini les classes et les fonctions template d'une maniere unique, pour 
tous les types et toutes les valeurs des parametres template. Cependant, il peut etre interessant de 
definir une version particuliere d'une classe ou d'une fonction pour un jeu particulier de parametres 

template. 

Par exemple, la pile de l'Exemple 12-5 peut etre implementee beaucoup plus efficacement si elle 
stocke des pointeurs plutot que des objets, sauf si les objets sont petits (ou appartiennent a un des types 
predefinis du langage). II peut etre interessant de manipuler les pointeurs de maniere transparente au 
niveau de la pile, pour que la methode pop renvoie toujours un objet, que la pile stocke des pointeurs 
ou des objets. Afin de realiser cela, il faut donner une deuxieme version de la pile pour les pointeurs. 

Le C++ permet tout cela : lorsqu'une fonction ou une classe template a ete definie, il est possible 
de la specialiser pour un certain jeu de parametres template. II existe deux types de specialisation : 
les specialisations totales, qui sont les specialisations pour lesquelles il n'y a plus aucun parametre 
template (ils ont tous une valeur bien determinee), et les specialisations partielles, pour lesquelles 
seuls quelques parametres template ont une valeur fixee. 
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12.5.1. Specialisation totale 

Les specialisations totales necessitent de fournir les valeurs des parametres template, separees par 
des virgules et entre les signes d'inferiorite et de superiorite, apres le nom de la fonction ou de la 
classe template. II faut faire preceder la definition de cette fonction ou de cette classe par la ligne 
suivante : 

template <> 

qui permet de signaler que la liste des parametres template pour cette specialisation est vide (et 
done que la specialisation est totale). 

Par exemple, si la fonction Min definie dans l'Exemple 12-4 doit etre utilisee sur une structure Struc- 
ture et se baser sur un des champs de cette structure pour effectuer les comparaisons, elle pourra etre 
specialisee de la maniere suivante : 

Exemple 12-12. Specialisation totale 

struct Structure 
{ 

int Clef; // Clef permettant de retrouver des donnees. 

void *pData; // Pointeur sur les donnees. 
}; 

template <> 

Structure Min<Structure> (Structure si. Structure s2) 

{ 

if (sl.Clef>s2.Clef ) 

return si; 
else 

return s2; 
} 

Note : Pour quelques compilateurs, la ligne declarant la liste vide des parametres template ne 
doit pas etre ecrite. On doit done faire des specialisations totale sans le mot cle template. Ce 
comportement n'est pas celui specifie par la norme, et le code ecrit pour ces compilateurs n'est 
done pas portable. 



12.5.2. Specialisation partielle 

Les specialisations partielles permettent de definir 1' implementation d'une fonction ou d'une classe 
template pour certaines valeurs de leurs parametres template et de garder d'autres parametres 
indefinis. II est meme possible de changer la nature d'un parametre template (e'est-a-dire preciser 
s'il s'agit d'un pointeur ou non) et de forcer le compilateur a prendre une implementation plutot 
qu'une autre selon que la valeur utilisee pour ce parametre est elle-meme un pointeur ou non. 

Comme pour les specialisations totales, il est necessaire de declarer la liste des parametres template 
utilises par la specialisation. Cependant, a la difference des specialisations totales, cette liste ne peut 
plus etre vide. 

Comme pour les specialisations totales, la definition de la classe ou de la fonction template doit uti- 
liser les signes d'inferiorite et de superiorite pour donner la liste des valeurs des parametres template 
pour la specialisation. 
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Exemple 12-13. Specialisation partielle 

// Definition d'une classe template : 
template <class Tl, class T2, int I> 
class A 
{ 

}; 

// Specialisation n° 1 de la classe : 
template <class T, int I> 
class A<T, T*, I> 
{ 

}; 

// Specialisation n° 2 de la classe : 
template <class Tl, class T2, int I> 
class A<T1*, T2, I> 
{ 

}; 

// Specialisation n° 3 de la classe : 
template <class T> 
class A<int, T*, 5> 
{ 

}; 



// Specialisation n° 4 de la classe : 
template <class Tl, class T2, int I> 
class A<T1, T2*, I> 
{ 

}; 



On notera que le nombre des parametres template declares a la suite du mot cle template peut 
varier, mais que le nombre de valeurs fournies pour la specialisation est toujours constant (dans 
F exemple precedent, il y en a trois). 

Les valeurs utilisees dans les identificateurs template des specialisations doivent respecter les regies 
suivantes : 

• une valeur ne peut pas etre exprimee en fonction d'un parametre template de la specialisation ; 

template <int I, int J> 

struct B 

{ 



template <int I> 

struct B<I, I*2> // Erreur ! 

{ // Specialisation incorrecte ! 

}; 

le type d'une des valeurs de la specialisation ne peut pas dependre d'un autre parametre 

template <class T, T t> 
struct C 



}; 
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template <class T> 

struct C<T, 1>; // Erreur ! 

// Specialisation incorrecte ! 

la liste des arguments de la specialisation ne doit pas etre identique a la liste implicite de la decla- 
ration template correspondante. 



Enfin, la liste des parametres template de la declaration d'une specialisation ne doit pas contenir 
des valeurs par defaut. On ne pourrait d'ailleurs les utiliser en aucune maniere. 



12.5.3. Specialisation d'une methode d'une classe template 

La specialisation partielle d'une classe peut parfois etre assez lourde a employer, en particulier si la 
structure de donnees qu'elle contient ne change pas entre les versions specialisees. Dans ce cas, il peut 
etre plus simple de ne specialiser que certaines methodes de la classe et non la classe complete. Cela 
permet de conserver la definition des methodes qui n'ont pas lieu d'etre modifiees pour les differents 
types, et d'eviter d'avoir a redefinir les donnees membres de la classe a l'identique. 

La syntaxe permettant de specialiser une methode d'une classe template est tres simple. II suffit 
en effet de considerer la methode comme une fonction template normale, et de la specialiser en 
precisant les parametres template a utiliser pour cette specialisation. 

Exemple 12-14. Specialisation de fonction membre de classe template 

#include <iostream> 
using namespace std; 



template <class 


T> 


class Item 




{ 




T item; 




public : 




Item(T) ; 




void set (T) ; 




T get (void) 


const; 


void print (void) const 


}; 




template <class 


T> 


Item<T>: : Item(T 


i) 


{ 




item = i; 




} 




// Accesseurs : 





// Constructeur 



template <class T> 
void Item<T>: :set (T i) 
{ 

item = i; 
} 
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template <class T> 

T Item<T>: : get (void) const 

{ 

return item; 

} 

// Fonction d'affichage generique : 

template <class T> 

void Item<T> :: print (void) const 

{ 

cout << item << endl; 
} 

// Fonction d'affichage specialisee explicitement pour le type int 

// et la methode print : 

template <> 

void Item<int *> : :print (void) const 

{ 

cout << *item << endl; 
} 



12.6. Mot-cle typename 



Nous avons deja vu que le mot cle typename pouvait etre utilise pour introduire les types generiques 
dans les declarations template. Cependant, il peut etre utilise dans un autre contexte pour introduire 
les identificateurs de types inconnus dans les template. En effet, un type generique peut tres bien 
etre une classe definie par l'utilisateur, a l'interieur de laquelle des types sont definis. Afin de pouvoir 
utiliser ces types dans les definitions des template, il est necessaire d'utiliser le mot cle typename 
pour les introduire, car a priori le compilateur ne sait pas que le type generique contient la definition 
d'un autre type. Ce mot cle doit etre place avant le nom complet du type : 

typename identif icateur 



Le mot cle typename est done utilise pour signaler au compilateur que l'identificateur identif : 
cateur est un type. 

Exemple 12-15. Mot-cle typename 

class A 
{ 
public : 

typedef int Y; // Y est un type defini dans la classe A. 
}; 

template <class T> 

class X 

{ 

typename T: :Y i; // La classe template X suppose que le 

// type generique T definisse un type Y. 

}; 
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X<A> x; 



// A peut servir a instancier une classe 
// a partir de la classe template X. 



12.7. Fonctions exportees 

Comme on l'a vu, les fonctions et classes template sont toutes instanciees lorsqu'elles sont ren- 
contrees pour la premiere fois par le compilateur ou lorsque la liste de leurs parametres est fournie 
explicitement. 

Cette regie a une consequence majeure : la definition complete des fonctions et des classes template 
doit etre incluse dans chacun des fichiers dans lequel elles sont utilisees. En general, les declarations et 
les definitions des fonctions et des classes template sont done regroupees ensemble dans les fichiers 
d'en-tete (et le code ne se trouve pas dans un fichier C++). Cela est a la fois tres lent (la definition doit 
etre relue par le compilateur a chaque fois qu'un template est utilise) et ne permet pas de proteger le 
savoir faire des entreprises qui editent des bibliotheques template, puisque leur code est accessible 
a tout le monde. 

Afin de resoudre ces problemes, le C++ permet de « compiler » les fonctions et les classes tem- 
plate, et ainsi d'eviter l'inclusion systematique de leur definition dans les fichiers sources. Cette 
« compilation » se fait a l'aide du mot cle export. 

Pour parvenir a ce resultat, vous devez declarer « export » les fonctions et les classes template 
concernees. La declaration d'une classe template export revient a declarer export toutes ses 
fonctions membres non inline, toutes ses donnees statiques, toutes ses classes membres et toutes 
ses fonctions membres template non statiques. Si une fonction template est declaree comme etant 
inline, elle ne peut pas etre de type export. 

Les fonctions et les classes template qui sont definies dans un espace de nommage anonyme ne 
peuvent pas etre declarees export. Voir le Chapitre 1 1 plus de details sur les espaces de nommage. 

Exemple 12-16. Mot-cle export 

export template <class T> 

void f(T); // Fonction dont le code n' est pas fourni 

// dans les fichiers qui l'utilisent. 

Dans cet exemple, la fonction f est declaree export. Sa definition est fournie dans un autre fichier, 
et n'a pas besoin d'etre fournie pour que f soit utilisable. 

Les definitions des fonctions et des classes declarees export doivent elles aussi utiliser le mot cle 
export. Ainsi, la definition de f pourra ressembler aux lignes suivantes : 

export template <class T> 

void f(T p) 

{ 

// Corps de la fonction. 

return ; 



Note : Aucun compilateur ne gere le mot cle export a ce jour. 
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Tout comme pour le langage C, pour lequel un certain nombre de fonctions ont ete definies et standar- 
dises et constituent la bibliotheque C, une bibliotheque de classes et de fonctions a ete specifiee pour 
le langage C++. Cette bibliotheque est le resultat de revolution de plusieurs bibliotheques, parfois 
developpees independamment par plusieurs fournisseurs d'environnements C++, qui ont ete fusion- 
nees et normalisees afin de garantir la portabilite des programmes qui les utilisent. Une des princi- 
pales briques de cette bibliotheque est sans aucun doute la STL (abreviation de « Standard Template 
Library »), a tel point qu'il y a souvent confusion entre les deux. 

Cette partie a pour but de presenter les principales fonctionnalites de la bibliotheque standard C++. 
Bien entendu, il est hors de question de decrire completement chaque fonction ou chaque detail du 
fonctionnement de la bibliotheque standard, car cela rendrait illisibles et incomprehensibles les ex- 
plications. Cependant, les informations de base vous seront donnees afin de vous permettre d'utiliser 
efficacement la bibliotheque standard C++ et de comprendre les fonctionnalites les plus avancees 
lorsque vous vous y interesserez. 

La bibliotheque standard C++ est reellement un sujet de taille. A titre indicatif, sa description est 
aussi volumineuse que celle du langage lui-meme dans la norme C++. Mais ce n'est pas tout, il faut 
imperativement avoir compris en profondeur les fonctionnalites les plus avancees du C++ pour appre- 
hender correctement la bibliotheque standard. En particulier, tous les algorithmes et toutes les classes 
fournies par la bibliotheque sont susceptibles de travailler sur des donnees de type arbitraire. La bi- 
bliotheque utilise done completement la notion de template, et se base surplusieurs abstractions des 
donnees manipulees et de leurs types afin de rendre generique 1' implementation des fonctionnalites. 
De plus, la bibliotheque utilise le mecanisme des exceptions afin de signaler les erreurs qui peuvent se 
produire lors de l'execution des methodes de ses classes et de ses fonctions. Enfin, un certain nombre 
de notions algorithmiques avancees sont utilisees dans toute la bibliotheque. La presentation qui sera 
faite sera done progressive, tout en essayant de conserver un ordre logique. Tout comme pour la par- 
tie precedente, il est probable que plusieurs lectures seront necessaires aux debutants pour assimiler 
toutes les subtilites de la bibliotheque. 

Le premier chapitre de cette partie (Chapitre 13) presente les notions de base qui sont utilisees dans 
toute la libraire : encapsulation des fonctions de la bibliotheque C classique, classes de traits pour les 
types de base, notion d'iterateurs, de foncteurs, d' allocateurs memoire et de complexite algorithmique. 
Le Chapitre 14 presente les types complementaires que la bibliotheque standard C++ definit pour 
faciliter la vie du programmeur. Le plus important de ces types est sans doute la classe de gestion 
des chaines de caracteres basic_string. Le Chapitre 15 presente les notions de flux d' entree / sortie 
standards, et la notion de tampon pour ces flux. Les mecanismes de localisation (e'est-a-dire les 
fonctions de parametrage du programme en fonction des conventions et des preferences nationales) 
seront decrits dans le Chapitre 16. Le Chapitre 17 est sans doute l'un des plus importants, puisqu'il 
presente tous les conteneurs fournis par la bibliotheque standard. Enfin, le Chapitre 18 decrit les 
principaux algorithmes de la bibliotheque, qui permettent de manipuler les donnees stockees dans les 
conteneurs. 

Les informations decrites ici sont basees sur la norme ISO 14882 du langage C++, et non sur la realite 
des environnements C++ actuels. II est done fortement probable que bon nombre d'exemples fournis 
ici ne soient pas utilisables tels quels sur les environnements de developpement existants sur le mar- 
che, bien que Ton commence a voir apparaitre des environnements presque totalement respectueux de 
la norme maintenant. De legeres differences dans 1' interface des classes decrites peuvent egalement 
apparaitre et necessiter la modification de ces exemples. Cependant, a terme, tous les environnements 
de developpement respecteront les interfaces specifiees par la norme, et les programmes utilisant la 
bibliotheque standard seront reellement portables au niveau source. 



Chapitre 13. Services et notions de base de la 
bibliotheque standard 

La bibliotheque standard C++ fournit un certain nombre de fonctionnalites de base sur lesquelles 
toutes les autres fonctionnalites de la bibliotheque s'appuient. Ces fonctionnalites apparaissent 
comme des classes d' encapsulation de la bibliotheque C et des classes d' abstraction des principales 
constructions du langage. Ces dernieres utilisent des notions tres evoluees pour permettre une 
encapsulation reellement generique des types de base. D' autre part, la bibliotheque standard utilise 
la notion de complexite algorithmique pour definir les contraintes de performance des operations 
realisables sur ses structures de donnees ainsi que sur ses algorithmes. Bien que complexes, toutes 
ces notions sont omnipresentes dans toute la bibliotheque, aussi est-il extremement important de les 
comprendre en detail. Ce chapitre a pour but de vous les presenter et de les eclaircir. 

13.1. Encapsulation de la bibliotheque C standard 

La bibliotheque C definit un grand nombre de fonctions C standards, que la bibliotheque standard 
C++ reprend a son compte et complete par toutes ses fonctionnalites avancees. Pour beneficier de ces 
fonctions, il suffit simplement d'inclure les fichiers d'en-tete de la bibliotheque C, tout comme on le 
faisait avec les programmes C classiques. 

Toutefois, les fonctions ainsi declarees par ces en-tetes apparaissent dans l'espace de nommage global, 
ce qui risque de provoquer des confiits de noms avec des fonctions homonymes (rappelons que les 
fonctions C ne sont pas surchargeables). Par consequent, et dans un souci d'homogeneite avec le reste 
des fonctionnalites de la bibliotheque C++, un jeu d' en-tetes complementaires a ete defini pour les 
fonctions de la bibliotheque C. Ces en-tetes definissent tous leurs symboles dans l'espace de nommage 
std : : , qui est reserve pour la bibliotheque standard C++. 

Ces en-tetes se distinguent des fichiers d'en-tete de la bibliotheque C par le fait qu'ils ne portent pas 
d' extension . h et par le fait que leur nom est prefixe par la lettre ' c' . Les en-tetes utilisables ainsi sont 
done les suivants : 

cassert 

cctype 

cerrno 

cf loat 

ciso646 

climits 

clocale 

cmath 

cset jmp 

csignal 

cstdarg 

cstddef 

cstdio 

cstdlib 

cstring 

ctime 

ewehar 

ewetype 

Par exemple, on peut reecrire notre tout premier programme que Ton a fait a la Section 1.9 de la 
maniere suivante : 

#include <cstdio> 
long double x, y; 
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int main (void) 
{ 

std: : printf ( "Calcul de moyenne\n"); 

std: : printf ( "Entrez le premier nombre : "); 

std: : scanf ("%Lf ", &x) ; 

std: : printf (" \nEntrez le deuxieme nombre : "); 

std: : scanf ("%Lf", &y) ; 

std: : printf (" \nLa valeur moyenne de %Lf et de %Lf est %Lf.\n", 
x, y, (x+y) 12) ; 

return 0; 



Note : L'utilisation systematique du prefixe std: : peut etre enervante sur les grands programmes. 
On aura done interet soit a utiliser les fichiers d'en-tete classiques de la bibliotheque C, soit a 
inclure une directive using namespace std; pour integrer les fonctionnalites de la bibliotheque 
standard dans I'espace de nommage global. 

Remarquez que la norme ne suppose pas que ces en-tetes soient des fichiers physiques. Les 
declarations qu'ils sont supposes faire peuvent done etre realisees a la volee par les outils de 
developpement, et vous ne les trouverez pas forcement sur votre disque dur. 



Certaines fonctionnalites fournies par la bibliotheque C ont ete encapsulees dans des fonctionnalites 
equivalentes de la bibliotheque standard C++. C'est notamment le cas pour la gestion des locales et 
la gestion de certains types de donnees complexes. C'est egalement le cas pour la determination des 
limites de representation que les types de base peuvent avoir. Classiquement, ces limites sont definies 
par des macros dans les en-tetes de la bibliotheque C, mais elles sont egalement accessibles au travers 
de la classe template numeric_limits, definie dans l'en-tete limits : 

// Types d' arrondis pour les flottants : 

enum f loat_round_style 

{ 

round_indeterminate = -1, 

round_toward_zero = 0, 

round_to_nearest = 1, 

round_toward_inf inity = 2, 

round_toward_neg_inf inity = 3 



template <class T> 
class numeric_limits 
{ 
public : 

static const bool is_specialized = false; 

static T min() throw (); 

static T max ( ) throw (); 

static const int digits = 0; 

static const int digitslO = 0; 

static const bool is_signed = false; 

static const bool is_integer = false; 

static const bool is_exact = false; 

static const int radix = 0; 

static T epsilonO throw (); 

static T round_error ( ) throw (); 
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static const int min_exponent = 0; 

static const int min_exponentlO = 0; 

static const int max_exponent = 0; 

static const int max_exponent 10 = 0; 

static const bool has_infinity = false; 

static const bool has_quiet_NaN = false; 

static const bool has_signaling_NaN = false; 

static const bool has_denorm = false; 

static const bool has_denorm_loss = false; 

static T infinity () throw)) ; 

static T quiet_NaN() throw)); 

static T signaling_NaN ( ) throw)); 

static T denorm_min ( ) throw)) ; 

static const bool is_iec559 = false; 

static const bool is_bounded = false; 

static const bool is_modulo = false; 

static const bool traps = false; 

static const bool tinyness_bef ore = false; 

static const f loat_round_style 

round_style = round_toward_zero; 



}; 



Cette classe template ne sert a rien en soi. En fait, elle est specialised pour tous les types de base du 
langage, et ce sont ces specialisations qui sont reellement utilisees. Elles permettent d'obtenir toutes 
les informations pour chaque type grace a leurs donnees membres et a leurs methodes statiques. 

Exemple 13-1. Determination des limites d'un type 

#include <iostream> 
#include <limits> 

using namespace std; 

int main (void) 
{ 

cout << numeric_limits<int> 

cout << numeric_limits<int> 

cout << numeric_limits<int> 

cout << numeric_limits<int> 

return 0; 
} 



:min ( ) << endl; 
:max ( ) << endl; 
: digits << endl; 
:digitsl0 << endl; 



Ce programme d' exemple determine le plus petit et le plus grand nombre representable avec le type 
entier int, ainsi que le nombre de bits utilises pour coder les chiffres et le nombre maximal de chiffres 
que les nombres en base 10 peuvent avoir en etant sur de pouvoir etre stockes tels quels. 



13.2. Definition des exceptions standards 

La bibliotheque standard utilise le mecanisme des exceptions du langage pour signaler les erreurs qui 
peuvent se produire a l'execution au sein de ses fonctions. Elle definit pour cela un certain nombre 
de classes d'exceptions standards, que toutes les fonctionnalites de la bibliotheque sont susceptibles 
d'utiliser. Ces classes peuvent etre utilisees telles quelles ou servir de classes de base a des classes 
d'exceptions personnalisees pour vos propres developpements. 
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Ces classes d'exception sont presque toutes declarees dans l'en-tete stdexcept, et derivent de la 
classe de base exception. Cette derniere n'est pas declaree dans le meme en-tete et n'est pas utilisee 
directement, mais fournit les mecanismes de base de toutes les exceptions de la bibliotheque standard. 
Elle est declaree comme suit dans l'en-tete exception : 

class exception 

{ 

public : 

exception () throw (); 

exception (const exception &) throw (); 

exception &operator= (const exception &) throw (); 

virtual -exception () throw (); 

virtual const char *what() const throw () ; 

}; 



Outre les constructeurs, operateurs d'affectation et destructeurs classiques, cette classe definit une 
methode what qui retourne une chaine de caracteres statique. Le contenu de cette chaine de carac- 
teres n'est pas normalise. Cependant, il sert generalement a decrire la nature de l'erreur qui s'est 
produite. C'est une methode virtuelle, car elle est bien entendu destinee a etre redefinie par les classes 
d'exception specialisees pour les differents types d'erreurs. Notez que toutes les methodes de la classe 
exception sont declarees comme ne pouvant pas lancer d' exceptions elle-memes, ce qui est naturel 
puisque Ton est deja en train de traiter une exception lorsqu'on manipule des objets de cette classe. 

L'en-tete exception contient egalement la declaration de la classe d'exception bad_exception. Cette 
classe n'est, elle aussi, pas utilisee en temps normal. Le seul cas ou elle peut etre lancee est dans le 
traitement de la fonction de traitement d'erreur qui est appelee par la fonction std: : unexpected 
lorsqu'une exception a provoque la sortie d'une fonction qui n'avait pas le droit de la lancer. La classe 
bad_exception est declaree comme suit dans l'en-tete exception : 

class bad_exception : public exception 

{ 

public : 

bad_exception ( ) throw (); 

bad_exception (const bad_exception &) throw (); 

bad_exception &operator= (const bad_exception &) throw (); 

virtual ~bad_exception ( ) throw (); 

virtual const char *what() const throw () ; 



Notez que l'exception bad_alloc lancee par les gestionnaires de memoire lorsque l'operateur new ou 
l'operateur new [ ] n'a pas reussi a faire une allocation n'est pas declaree dans l'en-tete stdexcept 
non plus. Sa declaration a ete placee avec celle des operateurs d'allocation memoire, dans l'en-tete 
new. Cette classe derive toutefois de la classe exception, comme le montre sa declaration : 

class bad_alloc : public exception 

{ 

public : 

bad_alloc() throw (); 

bad_alloc (const bad_alloc &) throw (); 

bad_alloc Soperator= (const bad_alloc &) throw (); 

virtual ~bad_alloc() throw (); 

virtual const char *what() const throw () ; 
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Les autres exceptions sont classees en deux grandes categories. La premiere categorie regroupe toutes 
les exceptions dont F apparition traduit sans doute une erreur de programmation dans le programme, 
car elles ne devraient jamais se produire a l'execution. II s'agit des exceptions dites « d'erreurs dans 
la logique du programme » et, en tant que telles, derivent de la classe d' exception logic_error. Cette 
classe est declaree comme suit dans l'en-tete stdexcept : 

class logic_error : public exception 

{ 

public : 

logic_error (const string &what_arg) ; 

}; 

Elle ne contient qu'un constructeur, permettant de definir la chaine de caracteres qui sera renvoyee 
par la methode virtuelle what. Ce constructeur prend en parametre cette chaine de caracteres sous 
la forme d'un objet de la classe string. Cette classe est definie par la bibliotheque standard afin de 
faciliter la manipulation des chaines de caracteres et sera decrite plus en detail dans la Section 14.1. 

Les classes d' exception qui derivent de la classe logic_error disposent egalement d'un constructeur 
similaire. Ces classes sont les suivantes : 

• la classe domain_error, qui specifie qu'une fonction a ete appelee avec des parametres sur lesquels 
elle n'est pas definie. II faut controler les valeurs des parametres utilisees lors de l'appel de la 
fonction qui a lance cette exception ; 

• la classe invalid_argument, qui specifie qu'un des arguments d'une methode ou d'une fonction 
n'est pas valide. Cette erreur arrive lorsqu'on utilise des valeurs de parametres qui n'entrent pas 
dans le cadre de fonctionnement normal de la methode appelee ; cela traduit souvent une mauvaise 
utilisation de la fonctionnalite correspondante ; 

• la classe length_error, qui indique qu'un depassement de capacite maximale d'un objet a ete reali- 
se. Ces depassements se produisent dans les programmes bogues, qui essaient d'utiliser une fonc- 
tionnalite au dela des limites qui avaient ete fixees pour elle ; 

• la classe out_of_range, qui specifie qu'une valeur situee en dehors de la plage de valeurs autorisees 
a ete utilisee. Ce type d'erreur signifie souvent que les parametres utilises pour un appel de fonction 
ne sont pas corrects ou pas initialises, et qu'il faut verifier leur validite. 



La deuxieme categorie d'exceptions correspond aux erreurs qui ne peuvent pas toujours etre corrigees 
lors de l'ecriture du programme, et qui font done partie des evenements naturels qui se produisent 
lors de son execution. Elles caracterisent les erreurs d'execution, et derivent de la classe d'exception 
runtime_error. Cette classe est declaree de la maniere suivante dans l'en-tete stdexcept : 

class runtime_error : public exception 

{ 

public : 

runtime_error (const string &what_arg) ; 

}; 

Elle s' utilise exactement comme la classe logic_error. 

Les exceptions de la categorie des erreurs d'execution sont les suivantes : 

• la classe range_error, qui signifie qu'une valeur est sortie de la plage de valeurs dans laquelle elle 
devait se trouver suite a un debordement interne a la bibliotheque ; 
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• la classe overflow_error, qui signifie qu'un debordement par valeurs superieures s'est produit dans 
un calcul interne a la bibliotheque ; 

• la classe underflow_error, qui signifie qu'un debordement par valeurs inferieures s'est produit dans 
un calcul interne a la bibliotheque. 



13.3. Abstraction des types de donnees : les traits 

Un certain nombre de classes ou d'algorithmes peuvent manipuler des types ay ant une signification 
particuliere. Par exemple, la classe string, que nous verrons plus loin, manipule des objets de type 
caractere. En realite, ces classes et ces algorithmes peuvent travailler avec n'importe quels types 
pourvu que tous ces types se comportent de la meme maniere. La bibliotheque standard C++ utilise 
done la notion de « traits », qui permet de definir les caracteristiques de ces types. Les traits sont 
definis dans des classes prevues a cet usage. Les classes et les algorithmes standards n'utilisent que 
les classes de traits pour manipuler les objets, garantissant ainsi une abstraction totale vis-a-vis de 
leurs types. Ainsi, il suffit de coder une specialisation de la classe des traits pour un type particulier 
afin de permettre son utilisation dans les algorithmes generiques. La bibliotheque standard definit bien 
entendu des specialisations pour les types de base du langage. 

Par exemple, la classe de definition des traits des types de caracteres est la classe template char_traits. 
Elle contient les definitions des types suivants : 

• le type char_type, qui est le type representant les caracteres eux-memes ; 

• le type int_type, qui est un type capable de contenir toutes les valeurs possibles pour les caracteres, 
y compris la valeur speciale du marqueur de fin de fichier ; 

• le type offjype, qui est le type permettant de representer les deplacements dans une sequence de 
caracteres, ainsi que les positions absolues dans cette sequence. Ce type est signe car les deplace- 
ments peuvent etre realises aussi bien vers le debut de la sequence que vers la fin ; 

• le type pos_type, qui est un sous-type du type offjype, et qui n'est utilise que pour les deplace- 
ments dans les fonctions de positionnement des flux de la bibliotheque standard ; 

• le type state_type, qui permet de representer l'etat courant d'une sequence de caracteres dans les 
fonctions de conversion. Ce type est utilise dans les fonctions de transcodage des sequences de 
caracteres d'un encodage vers un autre. 



Note : Pour comprendre I'utilite de ce dernier type, il faut savoir qu'il existe plusieurs manieres 
de coder les caracteres. La plupart des methodes utilisent un encodage a taille fixe, ou chaque 
caractere est represente par une valeur entiere et une seule. Cette technique est tres pratique 
pour les jeux de caracteres contenant moins de 256 caracteres, pour lesquels un seul octet est 
utilise par caractere. Elle est egalement utilisee pour les jeux de caracteres de moins de 65536 
caracteres, car I'utilisation de 16 bits par caracteres est encore raisonable. En revanche, les 
caracteres des jeux de caracteres orientaux sont codes avec des valeurs numeriques superieures 
a 65536 par les encodages standards (Unicode et ISO 10646), et ne peuvent done pas etre 
stockes dans les types char ou wchar_t. Pour ces jeux de caracteres, on utilise done souvent des 
encodages a taille variable, ou chaque caractere peut etre represente par un ou plusieurs octets 
selon sa nature et eventuellement selon sa position dans la chame de caracteres. 

Pour ces encodages a taille variable, il est evident que le positionnement dans les sequences 
de caracteres se fait en fonction du contexte de la chaine, a savoir en fonction de la position 
du caractere precedent et parfois en fonction des caracteres deja analyses. Les algorithmes de 
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la bibliotheque standard qui manipulent les sequences de caracteres doivent done stocker le 
contexte courant lors de I'analyse de ces sequences. Elles le font grace au type state_type de la 
classe des traits de ces caracteres. 



L'exemple suivant vous permettra de verifier que le type char_type de la classe de definition des traits 
pour le type char est bien entendu le type char lui-meme : 



#include <iostream> 
#include <typeinfo> 
#include <string> 

using namespace std; 

int main (void) 
{ 

// Recupere les informations de typage des traits : 
const type_info &ti_trait = 

typeid (char_traits<char> : : char_type) ; 
// Recupere les informations de typage directement : 
const type_info &ti_char = typeid (char ) ; 
// Compare les types : 
cout << "Le nom du type caractere des traits est : " << 

ti_trait .name ( ) << endl; 
cout << "Le nom du type char est : " << 

ti_char . name ( ) << endl; 
if (ti_trait == ti_char) 

cout << "Les deux types sont identiques." << endl; 
else 

cout << "Ce n'est pas le meme type." << endl; 
return 0; 
} 



La classe char_traits definit egalement un certain nombre de methodes travaillant sur les types de 
caracteres et permettant de realiser les operations de base sur ces caracteres. Ces methodes permettent 
essentiellement de comparer, de copier, de deplacer et de rechercher des caracteres dans des sequences 
de caracteres, en tenant compte de toutes les caracteristiques de ces caracteres. Elle contient egalement 
la definition de la valeur speciale utilisee dans les sequences de caracteres pour marquer les fin de flux 
(« EOF », abreviation de l'anglais « End Of File »). 

Par exemple, le programme suivant permet d'afficher la valeur utilisee pour specifier une fin de fichier 
dans une sequence de caracteres de type wchar_t : 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

char_traits<wchar_t> : : int_type wchar_eof = 

char_traits<wchar_t> : : eof ( ) ; 
cout << "La valeur de fin de fichier pour wchar_t est : " 
<< wchar_eof << endl; 
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return ; 
} 



Les autres methodes de la classe de definition des traits des caracteres, ainsi que les classes de de- 
finition des traits des autre types, ne seront pas decrites plus en detail ici. Elles sont essentiellement 
utilisees au sein des algorithmes de la bibliotheque standard et n'ont done qu'un interet limite pour 
les programmeurs, mais il est important de savoir qu'elles existent. 



13.4. Abstraction des pointeurs : les iterateurs 

La bibliotheque standard definit un certain nombre de structures de donnees evoluees, qui permettent 
de stocker et de manipuler les objets utilisateur de maniere optimale, evitant ainsi au programmeur 
d' avoir a reinventer la roue. On appelle ces structures de donnees des conteneurs. Ces conteneurs 
peuvent etre manipules au travers de fonctions speciales, selon un grand nombre d' algorithmes pos- 
sibles dont la bibliotheque dispose en standard. L' ensemble des fonctionnalites fournies par la biblio- 
theque permet de subvenir au besoin des programmeurs dans la majorite des cas. Nous detaillerons la 
notion de conteneur et les algorithmes disponibles plus loin dans ce document. 

La maniere d'acceder aux donnees des conteneurs depend bien entendu de leur nature et de leur struc- 
ture. Cela signifie qu'en theorie, il est necessaire de specialiser les fonctions permettant d'appliquer 
les algorithmes pour chaque type de conteneur existant. Cette technique n'est ni pratique, ni exten- 
sible, puisque les algorithmes fournis par la bibliotheque ne pourraient dans ce cas pas travailler sur 
des conteneurs ecrits par le programmeur. C'est pour cette raison que la bibliotheque standard utilise 
une autre technique pour acceder aux donnees des conteneurs. Cette technique est basee sur la notion 
d'iterateur. 



13.4.1. Notions de base et definition 

Un iterateur n'est rien d' autre qu'un objet permettant d'acceder a tous les objets d'un conteneur donne, 
souvent sequentiellement, selon une interface standardised. La denomination d'iterateur provient done 
du fait que les iterateurs permettent d'iterer sur les objets d'un conteneur, e'est-a-dire d'en parcourir 
le contenu en passant par tous ses objets. 

Comme les iterateurs sont des objets permettant d'acceder a d' autres objets, ils ne representent pas 
eux-memes ces objets, mais plutot le moyen de les atteindre. Ils sont done comparables aux pointeurs, 
dont ils ont exactement la meme semantique. En fait, les concepteurs de la bibliotheque standard 
se sont bases sur cette propriete pour definir l'interface des iterateurs, qui sont done une extension 
de la notion de pointeur. Par exemple, il est possible d'ecrire des expressions telles que « *i » ou 
« ++i » avec un iterateur i. Tous les algorithmes de la bibliotheque, qui travaillent normalement sur 
des iterateurs, sont done susceptibles de fonctionner avec des pointeurs classiques. 

Bien entendu, pour la plupart des conteneurs, les iterateurs ne sont pas de simples pointeurs, mais des 
objets qui se comportent comme des pointeurs et qui sont specifiques a chaque conteneur. Ainsi, les 
algorithmes sont ecrits de maniere uniforme, et ce sont les conteneurs qui fournissent les iterateurs 
qui leur sont appropries afin de permettre l'acces a leurs donnees. 

II n'y a que trois manieres d'obtenir un iterateur. Les iterateurs qui sont effectivement des pointeurs 
peuvent etre obtenus naturellement en prenant 1'adresse de l'element auquel ils donnent acces. Les 
pointeurs ne doivent etre utilises en tant qu' iterateurs que pour acceder aux donnees d'un tableau, car 
la semantique de 1' arithmetique des pointeurs suppose que les elements references successivement par 
un pointeur sont stockes en des emplacements contigus de la memoire. Pour les iterateurs de conte- 
neurs en revanche, il faut imperativement utiliser des methodes specifiques du conteneur pour obtenir 
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des iterateurs. La plupart des conteneurs fournissent une methode pour obtenir un iterateur initial, qui 
reference le premier element du conteneur, et une methode pour obtenir la valeur de l'iterateur lorsque 
le parcours du conteneur est acheve. Enfin, certains algorithmes et certaines methodes des conteneurs 
peuvent retourner un iterateur a l'issu de leur traitement. 

Quelle que soit la maniere d'obtenir les iterateurs, leur validite est soumise a des limites. 
Premierement, ils deviennent obligatoirement invalides des lors que le conteneur auquel ils 
permettent d'acceder est detruit. De plus, les conteneurs gerent leur structure de donnees de maniere 
dynamique, et sont susceptibles de la reorganiser des qu'on les manipule. On veillera done a ne plus 
utiliser les iterateurs d'un conteneur des qu'une methode permettant de le modifier aura ete appelee. 
Ne pas respecter cette regie conduirait, dans le meilleur des cas, a ne pas parcourir completement 
l'ensemble des objets du conteneur, et dans le pire des cas, a planter immediatement le programme. 



13.4.2. Classification des iterateurs 

La bibliotheque definit plusieurs categories d'iterateurs qui contiennent des iterateurs plus ou moins 
puissants. Le comportement des iterateurs les plus puissants se rapproche beaucoup des pointeurs 
classiques, et quasiment toutes les operations applicables aux pointeurs peuvent l'etre a ces itera- 
teurs. En revanche, les iterateurs des classes plus restrictives ne definissent qu'un sous-ensemble des 
operations que les pointeurs supportent, et ne peuvent done etre utilises que dans le cadre de ce jeu 
d' operations reduit. 

Les algorithmes de la bibliotheque n'utilisent que les iterateurs des classes les plus faibles permettant 
de realiser leur travail. Ils s'imposent ces restrictions afin de garantir leur utilisation correcte meme 
avec les iterateurs les plus simples. Bien entendu, comme les pointeurs disposent de toutes les fonc- 
tionnalites definies par les iterateurs, meme les plus puissants, les algorithmes standards fonctionnent 
egalement avec des pointeurs. Autrement dit, la bibliotheque standard est ecrite de facon a n'utiliser 
qu'une partie des operations applicables aux pointeurs, afin de garantir que ce qui fonctionne avec des 
iterateurs fonctionne avec des pointeurs. 

Les iterateurs de chaque categorie possedent toutes les proprietes des iterateurs des categories infe- 
rieures. II existe done une hierarchie dans la classification des iterateurs. Les categories definies par 
la bibliotheque standard sont les suivantes : 

• les iterateurs de la categorie « Output » sont utilises pour effectuer des affectations de valeurs aux 
donnees qu'ils referencent. Ces iterateurs ne peuvent done etre dereferences par l'operateur ' *' que 
dans le cadre d'une affectation. II est impossible de lire la valeur d'un iterateur de type Output, et 
on ne doit ecrire dans la valeur qu'ils referencent qu'une fois au plus. Les algorithmes qui utilisent 
ces iterateurs doivent done imperativement ne faire qu'une seule passe sur les donnees iterees ; 

• les iterateurs de la categorie « Input » sont similaires aux iterateurs de type Output, a ceci pres 
qu'ils ne peuvent etre dereferences que pour lire une valeur. Contrairement aux iterateurs de type 
Output, il est possible de comparer deux iterateurs. Cependant, le fait que deux iterateurs soient 
egaux ne signifie aucunement que leurs successeurs le seront encore. Les algorithmes qui utilisent 
les iterateurs de type Input ne peuvent done faire aucune hypothese sur l'ordre de parcours utilise 
par l'iterateur. Ce sont done necessairement des algorithmes en une passe ; 

• les iterateurs de la categorie « Forward » possedent toutes les fonctionnalites des iterateurs de 
type Input et de type Output. Comme ceux-ci, ils ne peuvent passer que d'une valeur a la suivante, 
et jamais reculer ou revenir a une valeur deja iteree. Les algorithmes qui utilisent des iterateurs 
de cette categorie s'imposent done de ne parcourir les donnees des conteneurs que dans un seul 
sens. Cependant, la restriction imposee sur l'egalite des operateurs de type Input est levee, ce qui 
signifie que plusieurs parcours successifs se feront dans le meme ordre. Les algorithmes peuvent 
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effectuer plusieurs parcours, par exemple en copiant la valeur initiale de l'iterateur et en parcourant 
le conteneur plusieurs fois avec chaque copie ; 

• les iterateurs de la categorie « Bidirectionnal » disposent de toutes les fonctionnalites des iterateurs 
de type Forward, mais levent la restriction sur le sens de parcours. Ces iterateurs peuvent done 
revenir sur les donnees deja iterees, et les algorithmes qui les utilisent peuvent done travailler en 
plusieurs passes, dans les deux directions ; 

• enfin, les iterateurs de la categorie « RandomAccess » sont les plus puissants. lis fournissent toutes 
les fonctionnalites des iterateurs de type Bidirectionnal, plus la possibilite d'acceder aux elements 
des conteneurs par l'intermediaire d'un index en un temps constant. II n'y a done plus de notion 
de sens de parcours, et les donnees peuvent etre accedees comme les donnees d'un tableau. II est 
egalement possible d'effectuer les operations classiques de 1' arithmetique des pointeurs sur ces 
iterateurs. 



Tous les iterateurs de la bibliotheque standard derivent de la classe de base suivante : 

template <class Category, 

class T, class Distance = ptrdiff_t, 

class Pointer = T*, class Reference = T &> 
struct iterator 
{ 

typedef T value_type; 

typedef Distance dif ference_type; 

typedef Pointer pointer; 

typedef Reference reference; 

typedef Category iterator_category; 



Cette classe est declaree dans l'en-tete iterator. 

Cette classe definit les types de base des iterateurs, a savoir : le type des valeurs referencees, le type 
de la difference entre deux iterateurs dans les calculs d' arithmetique des pointeurs, le type des poin- 
teurs des valeurs referencees par l'iterateur, le type des references pour ces valeurs et la categorie de 
l'iterateur. Ce dernier type doit etre l'une des classes suivantes, egalement definies par la bibliotheque 
standard : 

input_iterator_tag, pour les iterateurs de la categorie des iterateurs de type Input ; 
output_iterator_tag, pour les iterateurs de la categorie des iterateurs de type Output ; 
forward_iterator_tag, pour les iterateurs de la categorie des iterateurs de type Forward ; 
bidirectionnal_iterator_tag, pour les iterateurs de la categorie des iterateurs bidirectionnels ; 
random_access_iterator_tag, pour les iterateurs de la categorie des iterateurs a acces complet. 



Notez que le type par defaut pour la difference entre deux pointeurs est le type ptrdiff_t, qui est 
utilise classiquement pour les pointeurs normaux. De meme, le type pointeur et le type reference 
correspondent respectivement, par defaut, aux types T * et T &. Pour les iterateurs pour lesquels ces 
types n'ont pas de sens, le type utilise est void, ce qui permet de provoquer une erreur de compilation 
si on cherche a les utiliser. 

Ces types sont utilises par les iterateurs nativement, cependant, ils ne le sont generalement pas par 
les algorithmes. En effet, ceux-ci sont susceptibles d'etre appelees avec des pointeurs normaux, et les 
pointeurs ne definissent pas tous ces types. C'est pour cette raison qu'une classe de traits a ete definie 
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pour les iterateurs par la bibliotheque standard. Cette classe est declaree comme suit dans l'en-tete 

iterator : 

template <class Iterator> 
struct iterator_traits 
{ 

typedef Iterator : :value_type value_type; 

typedef Iterator :: cliff erence_type dif ference_type; 

typedef Iterator : :pointer pointer; 

typedef Iterator :: reference reference; 

typedef Iterator :: iterator_category iterator_category; 



La classe des traits permet done d'obtenir de maniere independante de la nature de l'iterateur la valeur 
des types fondamentaux de l'iterateur. Comme ces types n'existent pas pour les pointeurs classiques, 
cette classe est specialised de la maniere suivante : 

template <class T> 

struct iterator_traits<T *> 

{ 

typedef T value_type; 

typedef ptrdiff_t dif ference_type; 

typedef T *pointer; 

typedef T Sreference; 

typedef random_access_iterator_tag iterator_category; 



Ainsi, le type iterator_traits<iterateur>::difference_type renverra toujours le type permettant de sta- 
cker la difference entre deux iterateurs, que ceux-ci soient des iterateurs ou des pointeurs normaux. 

Pour comprendre l'importance des traits des iterateurs, prenons l'exemple de deux fonctions fournies 
par la bibliotheque standard permettant d'avancer un iterateur d'un certain nombre d'etapes, et de 
calculer la difference entre deux iterateurs. II s'agit respectivement des fonctions advance et dis- 
tance. Ces fonctions devant pouvoir travailler avec n'importe quel iterateur, et n'importe quel type 
de donnee pour exprimer la difference entre deux iterateurs, elles utilisent la classe des traits. Elles 
sont declarees de la maniere suivante dans l'en-tete iterator : 

template <class Inputlterator, class Distance> 
void advance ( Input Iterator &i, Distance n) ; 

template <class InputIterator> 
iterator_traits<InputIterator> : : dif f erence_type 

distance ( Input Iterator first, Inputlterator last); 

Notez que le type de retour de la fonction distance est Iterator: :difference_type pour les iterateurs 
normaux, et ptrdiff_t pour les pointeurs. 

Note : Ces deux methodes ne sont pas tres efficaces avec les iterateurs de type Forward, car 
elles doivent parcourir les valeurs de ces iterateurs une a une. Cependant, elles sont specialisees 
pour les iterateurs de type plus evolues (en particulier les iterateurs a acces complet), et sont done 
plus efficaces pour eux. Elles permettent done de manipuler les iterateurs de maniere uniforme, 
sans pour autant compromettre les performances. 
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13.4.3. Iterateurs adaptateurs 

Les iterateurs sont une notion extremement utilisee dans toute la bibliotheque standard, car ils re- 
groupent toutes les fonctionnalites permettant d'effectuer un traitement sequentiel des donnees. Ce- 
pendant, il n'existe pas toujours d'iterateur pour les sources de donnees que Ton manipule. La bi- 
bliotheque standard fournit done ce que Ton appelle des iterateurs adaptateurs, qui permettent de 
manipuler ces structures de donnees en utilisant la notion d'iterateur meme si ces structures ne gerent 
pas elles-memes la notion d'iterateur. 

13.4.3.1. Adaptateurs pour les flux d'entree / sortie standards 

Les flux d'entree / sortie standards de la bibliotheque sont normalement utilises avec les operations 
'>>' et '<<', respectivement pour recevoir et pour envoyer des donnees. II n'existe pas d'iterateur 
de type Input et de type Output permettant de lire et d'ecrire sur ces flux. La bibliotheque definit done 
des adaptateurs permettant de construire ces iterateurs. 

L'iterateur adaptateur pour les flux d'entree est implemente par la classe template istream_iterator. 
Cet adaptateur est declare comme suit dans l'en-tete iterator : 

template <class T, class charT, class traits = char_traits<charT>, 

class Distance=ptrdif f_t> 
class istream_iterator : 

public iterator<input_iterator_tag, T, Distance, 
const T *, const T &> 
{ 
public : 

typedef charT char_type; 

typedef traits trait_type; 

typedef basic_istream<char, traits> istream_type; 

istream_iterator ( ) ; 

istream_iterator (istream_iterator &f lux) ; 

istream_iterator (const istream_iterator<T, charT, traits, 
Distance> Sflux) ; 

~istream_iterator ( ) ; 

const T &operator*() const; 

const T *operator-> ( ) const; 

istream_iterator<T, charT, traits, Distance> &operator + + ( ) ; 

istream_iterator<T, charT, traits, Distance> operator++ (int ) ; 

}; 

Les operateurs d'egalite et d'inegalite sont egalement definis pour cet iterateur. 

Comme vous pouvez le constater d'apres cette declaration, il est possible de construire un iterateur 
sur un flux d'entree permettant de lire les donnees de ce flux une a une. S'il n'y a plus de donnees a 
lire sur ce flux, l'iterateur prend la valeur de l'iterateur de fin de fichier pour le flux. Cette valeur est 
celle qui est attribute a tout nouvel iterateur construit sans flux d'entree. L'exemple suivant presente 
comment faire la somme de plusieurs nombres lus sur le flux d'entree, et de l'afficher lorsqu'il n'y a 
plus de donnees a lire. 

Exemple 13-2. Iterateurs de flux d'entree 

#include <iostream> 
#include <iterator> 

using namespace std; 

int main (void) 
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double somme = 0; 

istream_iterator<double, char> is (cin) ; 

while (is != istream_iterator<double, char>()) 

{ 

somme = somme + *is; 

+ + is; 
} 
cout << "La somme des valeurs lue est : " << 

somme << endl; 
return 0; 



} 



Vous pourrez essayer ce programme en tapant plusieurs nombres successivement puis en envoyant 
un caractere de fin de fichier avec la combinaison de touches CTRL + z. Ce caractere provoquera la 
sortie de la boucle while et affichera le resultat. 

L'iterateur adaptateur pour les flux de sortie fonctionne de maniere encore plus simple, car il n'y a 
pas a faire de test sur la fin de fichier. II est declare comme suit dans l'en-tete iterator : 

template <class T, class charT = char, class traits = char_traits<charT> > 
class ostream_iterator : 

public iterator<output_iterator_tag, void, void, void, void> 
{ 
public : 

typedef charT char_type; 

typedef traits trait_type; 

typedef basic_ostream<charT, traits> ostream_type; 

ostream_iterator (ostream_type Sflux) ; 

ostream_iterator (ostream_type Sflux, const charT *separateur) ; 

ostream_iterator (const ostream_iterator<T, charT, traits> Sflux); 

~ostream_iterator ( ) ; 

ostream_iterator<T, charT, traits> Soperator= (const T Svaleur) ; 

ostream_iterator<T, charT, traits> Soperator* ( ) ; 

ostream_iterator<T, charT, traits> Soperator + t ( ) ; 

ostream_iterator<T, charT, traits> &operator + + (int ) ; 

}; 



Cet iterateur est de type Output, et ne peut done etre dereference que dans le but de faire une ecri- 
ture dans 1'objet ainsi obtenu. Ce dereferencement retourne en fait l'iterateur lui-meme, si bien que 
l'ecriture provoque l'appel de l'operateur d'affectation de l'iterateur. Cet operateur envoie simple- 
ment les donnees sur le flux de sortie que l'iterateur prend en charge et renvoie sa propre valeur afin 
de realiser une nouvelle ecriture. Notez que les operateurs d' incrementation existent egalement, mais 
ne font strictement rien. lis ne sont la que pour permettre d'utiliser ces iterateurs comme de simples 
pointeurs. 

L'iterateur ostream_iterator peut envoy er sur le flux de sortie un texte intercalaire entre chaque donnee 
qu'on y ecrit. Ce texte peut servir a inserer des separateurs entre les donnees. Cette fonctionnalite peut 
s'averer tres pratique pour l'ecriture de donnees formatees. Le texte a inserer automatiquement doit 
etre passe en tant que deuxieme argument du constructeur de l'iterateur. 



211 



Chapitre 13. Services et notions de base de la bibliotheque standard 

Exemple 13-3. Iterateur de flux de sortie 

#include <iostream> 
#include <iterator> 

using namespace std; 

const char *texte[6] = { 

"Bonjour", "tout", "le", "monde", "!", NULL 

}; 

int main (void) 
{ 

ostream_iterator<const char *, char> os(cout, " "); 

int i = 0; 

while (texte[i] != NULL) 

{ 

*os = texte[i]; // Le dereferencement est facultatif. 
++os; // Cette ligne est facultative. 

+ + i; 
} 

cout << endl; 
return 0; 
} 

II existe egalement des adaptateurs pour les tampons de flux d' entree / sortie basic_streambuf. Le 
premier adaptateur est implemente par la classe template istreambuf_iterator. II permet de lire les 
donnees provenant d'un tampon de flux basic_streambuf aussi simplement qu'en manipulant un poin- 
teur et en lisant la valeur de l'objet pointe. Le deuxieme adaptateur, ostreambuf_iterator, permet quant 
a lui d'ecrire dans un tampon en affectant une nouvelle valeur a l'objet reference par l'iterateur. Ces 
adaptateurs fonctionnent done exactement de la meme maniere que les iterateurs pour les flux d' entree 
/ sortie formates. En particulier, la valeur de fin de fichier que prend l'iterateur d' entree peut etre re- 
cuperet a l'aide du constructeur par defaut de la classe istreambuf_iterator, instanciee pour le type de 
tampon utilise. 

Note : L'operateur de decrementation suffixe des iterateurs istreambuf_iterator a un type de 
retour particulier qui permet de representor la valeur precedente de l'iterateur avant incremen- 
tation. Les objets de ce type sont toujours dereferengables a l'aide de l'operateur '*'. La raison 
de cette particularity est que le contenu du tampon peut etre modifie apres I'appel de l'operateur 
'operator ++ (int) ', mais I'ancienne valeur de cet iterateur doit toujours permettre d'acceder a 
l'objet qu'il referengait. La valeur retoumee par l'iterateur contient done une sauvegarde de cet ob- 
jet et peut se voir appliquer l'operateur de dereferencement '*' par I'appelant afin d'en recuperer 
la valeur. 

La notion de tampon de flux sera presentee en detail dans la Section 15.2. 



13.4.3.2. Adaptateurs pour I'insertion d'elements dans les conteneurs 

Les iterateurs fournis par les conteneurs permettent d'en parcourir le contenu et d'obtenir une refe- 
rence sur chacun de leurs elements. Ce comportement est tout a fait classique et constitue meme une 
des bases de la notion d'iterateur. Toutefois, I'insertion de nouveaux elements dans un conteneur ne 
peut se faire que par 1' intermediate des methodes specifiques aux conteneurs. La bibliotheque stan- 
dard C++ definit done des adaptateurs pour des iterateurs dits A' insertion, qui permettent d'inserer 
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des elements dans des conteneurs par un simple dereferencement et une ecriture. Grace a ces adapta- 
teurs, l'insertion des elements dans les conteneurs peut etre realisee de maniere uniforme, de la meme 
maniere qu'on ecrirait dans un tableau qui se redimensionnerait automatiquement, a chaque ecriture. 

II est possible d'inserer les nouveaux elements en plusieurs endroits dans les conteneurs. Ainsi, les 
elements peuvent etre places au debut du conteneur, a sa fin, ou apres un element donne. Bien entendu, 
ces notions n'ont de sens que pour les conteneurs qui ne sont pas ordonnes, puisque dans le cas 
contraire, la position de l'element insere est determinee par le conteneur lui-meme. 

La classe template back_insert_iterator est la classe de l'adaptateur d'insertion en fin de conteneur. 
Elle est declaree comme suit dans l'en-tete iterator : 

template <class Container> 
class back_insert_iterator : 

public iterator<output_iterator_tag, void, void, void, void> 
{ 
public : 

typedef Container container_type; 

explicit back_insert_iterator (Container Sconteneur) ; 

back_insert_iterator<Container> S 

operator= (const typename Container : :value_type Svaleur) ; 

back_insert_iterator<Container> Soperator* () ; 

back_insert_iterator<Container> Soperator++ () ; 

back_insert_iterator<Container> operator++ (int) ; 



Comme vous pouvez le constater, les objets des instances cette classe peuvent etre utilises comme 
des iterateurs de type Output. L'operateur de dereferencement '*' renvoie l'iterateur lui-meme, si 
bien que les affectations sur les iterateurs dereferences sont traitees par l'operateur 'operator=' de 
l'iterateur lui-meme. C'est done cet operateur qui ajoute l'element a affecter a la fin du conteneur 
auquel l'iterateur permet d'acceder, en utilisant la methode push_back de ce dernier. 

De meme, la classe template front_insert_iterator de l'adaptateur d'insertion en tete de conteneur 
est declaree comme suit dans l'en-tete iterator : 

template <class Container> 
class f ront_insert_iterator : 

public iterator<output_iterator_tag, void, void, void, void> 
{ 
public : 

typedef Container container_type; 

explicit front_insert_iterator (Container Sconteneur); 

f ront_insert_iterator<Container> & 

operator= (const typename Container : :value_type Svaleur); 

f ront_insert_iterator<Container> Soperator* () ; 

f ront_insert_iterator<Container> Soperator++ () ; 

f ront_insert_iterator<Container> operator++ (int ) ; 

}; 

Son fonctionnement est identique a celui de back_insert_iterator, a ceci pres qu'il effectue les inser- 
tions des elements au debut du conteneur, par 1' intermediate de sa methode push_f ront. 

Enfin, la classe template de l'adaptateur d'iterateur d'insertion a une position donnee est declaree 
comme suit : 

template <class Container> 
class insert_iterator : 

public iterator<output_iterator_tag, void, void, void, void> 
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public : 

typedef Container container_type; 
insert_iterator (Container Sconteneur, 

typename Container :: iterator position); 
insert_iterator<Container> & 

operator= (const typename Container : :value_type Svaleur) ; 
insert_iterator<Container> Soperator* () ; 
insert_iterator<Container> Soperator++ () ; 
insert_iterator<Container> operator++ (int) ; 



Le constructeur de cette classe prend en parametre, en plus du conteneur sur lequel l'iterateur 
d' insertion doit travailler, un iterateur specifiant la position a laquelle les elements doivent etre 
inseres. Les elements sont inseres juste avant l'element reference par l'iterateur fourni en parametre. 
De plus, ils sont inseres sequentiellement, les uns apres les autres, dans leur ordre d' affectation via 
l'iterateur. 

La bibliotheque standard C++ fournit trois fonctions template qui permettent d'obtenir les trois 
types d'iterateur d'insertion pour chaque conteneur. Ces fonctions sont declarees comme suit dans 
l'en-tete iterator : 

template <class Container> 
back_insert_iterator<Container> 

back_inserter (Container Sconteneur) ; 

template <class Container> 

f ront_insert_iterator<Container> 

front_inserter (Container Sconteneur) ; 

template <class Container, class Iterator> 
insert_iterator<Container> 

inserter (Container Sconteneur, Iterator position) ; 



Le programme suivant utilise un iterateur d'insertion pour remplir une liste d' element, avant d'en 
afficher le contenu. 

Exemple 13-4. Iterateur d'insertion 

#include <iostream> 
#include <list> 
#include <iterator> 

using namespace std; 

// Definit le type liste d'entier : 
typedef list<int> li_t; 

int main ( ) 
{ 

// Cree une liste : 

li_t 1st; 

// Insere deux elements dans la liste de la maniere classique : 

1st .push_back (1 ) ; 

1st .push_back (10) ; 
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II Recupere un iterateur referencant le premier element : 

li_t :: iterator it = Ist.beginO; 

// Passe au deuxieme element : 

+ + it; 

// Construit un iterateur d' insertion pour inserer de nouveaux 

// elements avant le deuxieme element de la liste : 

insert_iterator<li_t> ins_it = inserter (1st , it); 

// Insere les elements avec cet iterateur : 

for (int i = 2; i < 10; ++i) 



*ins_it = 
++ins_it ; 



i; 



// Affiche le contenu de la liste 
it = 1st .begin ( ) ; 
while (it != 1st . end ( ) ) 
{ 

cout << *it << endl; 

++it; 
} 
return 0; 



La maniere d'utiliser le conteneur de type list sera decrite en detail dans le Chapitre 17. 



13.4.3.3. Iterateur inverse pour les iterateurs bidirectionnels 

Les iterateurs bidirectionnels et les iterateurs a acces aleatoire peuvent etre parcourus dans les deux 
sens. Pour ces iterateurs, il est done possible de definir un iterateur associe dont le sens de parcours 
est inverse. Le premier element de cet iterateur est done le dernier element de l'iterateur associe, et 
inversement. 

La bibliotheque standard C++ definit un adaptateur permettant d'obtenir un iterateur inverse facile- 
ment dans l'en-tete iterator. II s'agit de la classe template reverse_iterator : 



template <class Iterator> 

class reverse_iterator : 
public iterator< 

iterator_traits<Iterator> 
iterator_traits<Iterator> 
iterator_traits<Iterator> 
iterator_traits<Iterator> 
iterator_traits<Iterator> 



: iterator_category, 

: value_type, 

: dif f erence_type, 

:pointer, 

: ref erence> 



{ 

public : 

typedef Iterator iterator_type; 
reverse_iterator ( ) ; 

explicit reverse_iterator (Iterator iterateur); 
Iterator based const; 
Reference operator* () const; 
Pointer operator->() const; 
reverse_iterator &operator++ ( ) ; 
reverse_iterator operator++ (int) ; 
reverse_iterator Soperator— () ; 
reverse_iterator operator-- (int) ; 

reverse_iterator operatort (Distance delta) const; 
reverse_iterator &operator+= (Distance delta); 
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reverse_iterator operator- (Distance delta) const; 
reverse_iterator &operator-= (Distance delta); 
Reference operator [] (Distance delta) const; 
}; 

Les operateurs de comparaison classiques et d' arithmetique des pointeurs externes operatort et 
operator- sont egalement definis dans cet en-tete. 

Le constructeur de cet adaptateur prend en parametre l'iterateur associe dans le sens inverse duquel 
le parcours doit se faire. L'iterateur inverse pointera alors automatiquement sur l'element precedent 
l'element pointe par l'iterateur passe en parametre. Ainsi, si on initialise l'iterateur inverse avec la 
valeur de fin de l'iterateur direct, il referencera le dernier element que l'iterateur direct aurait reference 
avant d'obtenir sa valeur finale dans un parcours des elements du conteneur. La valeur de fin de 
l'iterateur inverse peut etre obtenue en construisant un iterateur inverse a partir de la valeur de debut 
de l'iterateur direct. 

Note : Notez que le principe specifiant que I'adresse suivant celle du dernier element d'un tableau 
doit toujours etre une adresse valide est egalement en vigueur pour les iterateurs. La valeur de 
fin d'un iterateur est assimilable a cette adresse, pointant sur I'emplacement suivant le dernier 
element d'un tableau, et n'est pas plus dereferengable, car elle se trouve en dehors du tableau. 
Cependant, elle peut etre utilisee dans les calculs d'arithmetique des pointeurs, et c'est exacte- 
ment ce que fait I'adaptateur reversejterator. 



La methode base permet de recuperer la valeur de l'iterateur direct associe a l'iterateur inverse. On 
prendra garde que l'iterateur renvoye par cette methode ne reference pas le meme element que celui 
reference par l'iterateur inverse. En effet, l'element reference est toujours l'element suivant l'element 
reference par l'iterateur inverse, en raison de la maniere dont cet iterateur est initialise. Par exemple, 
l'iterateur inverse reference le dernier element du conteneur lorsqu'il vient d'etre intialise avec la 
valeur de fin de l'iterateur directe, valeur qui represente le dernier element passe. De meme, lorsque 
l'iterateur inverse a pour valeur sa valeur de fin d' iteration (ce qui represente l'element precedent le 
premier element du conteneur en quelque sorte), l'iterateur direct reference le premier element du 
conteneur. 

En fait, les iterateurs inverses sont utilises en interne par les conteneurs pour fournir des iterateurs 
permettant de parcourir leurs donnees dans le sens inverse. Le programmeur n' aura done generalement 
pas besoin de construire des iterateurs inverses lui-meme, il utilisera plutot les iterateurs fournis par 
les conteneurs. 

Exemple 13-5. Utilisation d'un iterateur inverse 

#include <iostream> 
tinclude <list> 
#include <iterator> 

using namespace std; 

// Definit le type liste d'entier : 
typedef list<int> li_t; 

int main (void) 
{ 

// Cree une nouvelle liste : 

li_t li; 

// Remplit la liste : 
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for (int i = 0; i < 10; ++i) 

li .push_back (i ) ; 
// Affiche le contenu de la liste a l'envers 
li_t : : reverse_iterator rev_it = li.rbeginO; 
while (rev_it != li.rendO) 
{ 

cout << *rev_it << endl; 

++rev_it ; 
} 
return 0; 



13.5. Abstraction des fonctions : les foncteurs 

La plupart des algorithmes de la bibliotheque standard, ainsi que quelques methodes des classes 
qu'elle fournit, donnent la possibilite a l'utilisateur d'appliquer une fonction aux donnees manipu- 
lees. Ces fonctions peuvent etre utilisees pour differentes taches, comme pour comparer deux objets 
par exemple, ou tout simplement pour en modifier la valeur. 

Cependant, la bibliotheque standard n' utilise pas ces fonctions directement, mais a plutot recours 
a une abstraction des fonctions : les foncteurs. Un foncteur n'est rien d'autre qu'un objet dont la 
classe definit 1'operateur fonctionnel ' () '. Les foncteurs ont la particularite de pouvoir etre utilises 
exactement comme des fonctions puisqu'il est possible de leur appliquer leur operateur fonctionnel 
selon une ecriture similaire a un appel de fonction. Cependant, ils sont un peu plus puissants que de 
simples fonctions, car ils permettent de transporter, en plus du code de 1'operateur fonctionnel, des 
parametres additionnels dans leurs donnees membres. Les foncteurs constituent done une fonctionna- 
lite extremement puissante qui peut etre tres pratique en de nombreux endroits. En fait, comme on le 
verra plus loin, toute fonction peut etre transformee en foncteur. Les algorithmes de la bibliotheque 
standard peuvent done egalement etre utilises avec des fonctions classiques moyennant cette petite 
transformation. 

Les algorithmes de la bibliotheque standard qui utilisent des foncteurs sont declares avec un parametre 
template dont la valeur sera celle du foncteur permettant de realiser l'operation a appliquer sur les 
donnees en cours de traitement. Au sein de ces algorithmes, les foncteurs sont utilises comme de 
simples fonctions, et la bibliotheque standard ne fait done pas d'autre hypothese sur leur nature. 
Cependant, il est necessaire de ne donner que des foncteurs en parametres aux algorithmes de la 
bibliotheque standard, pas des fonctions. C'est pour cette raison que la bibliotheque standard definit 
un certain nombre de foncteurs standards afin de faciliter la tache du programmeur. 

13.5.1. Foncteurs predefinis 

La bibliotheque n'utilise, dans ses algorithmes, que des foncteurs qui ne prennent qu'un ou deux 
parametres. Les foncteurs qui prennent un parametre et un seul sont dits « unaires », alors que les 
foncteurs qui prennent deux parametres sont qualifies de « binaires ». Afin de faciliter la creation de 
foncteurs utilisables avec ses algorithmes, la bibliotheque standard definit deux classes de base qui 
pour les foncteurs unaires et binaires. Ces classes de base sont les suivantes : 

template <class Arg, class Result> 

struct unary_function 

{ 

typedef Arg argument_type; 

typedef Result result_type; 
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}; 

template <class Argl, class Arg2, class Result> 

struct binary_f unction 

{ 

typedef Argl f irst_argument_type; 

typedef Arg2 second_argument_type; 

typedef Result result_type; 
}; 

Ces classes sont definies dans l'en-tete functional. 

La bibliotheque definit egalement un certain nombre de foncteurs standards qui encapsulent les ope- 
rateurs du langage dans cet en-tete. Ces foncteurs sont les suivants : 

template <class T> 

struct plus : binary_f unction<T, T, T> 

{ 

T operator () (const T Soperandel, const T soperande2) const; 
}; 

template <class T> 

struct minus : binary_f unction<T, T, T> 

{ 

T operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct multiplies : binary_f unction<T, T, T> 

{ 

T operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct divides : binary_f unction<T, T, T> 

{ 

T operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct modulus : binary_f unction<T, T, T> 

{ 

T operator () (const T soperandel, const T soperande2) const; 



template <class T> 

struct negate : unary_function<T, T> 

{ 

T operator () (const T soperande) const; 



template <class T> 

struct equal_to : binary_function<T, T, bool> 

{ 

bool operator!) (const T soperandel, const T soperande2) const; 



template <class T> 
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struct not_equal_to : binary_f unction<T, T, bool> 
{ 

bool operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct greater : binary_function<T, T, bool> 

{ 

bool operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct less : binary_f unction<T, T, bool> 

{ 

bool operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct greater_equal : binary_function<T, T, bool> 

{ 

bool operator () (const T soperandel, const T soperande2) const; 
}; 

template <class T> 

struct less_equal : binary_f unction<T, T, bool> 

{ 

bool operator () (const T soperandel, const T soperande2) const; 



Ces foncteurs permettent d'utiliser les principaux operateurs du langage comme des fonctions clas- 
siques dans les algorithmes de la bibliotheque standard. 

Exemple 13-6. Utilisation des foncteurs predefinis 

#include <iostream> 
#include <functional> 

using namespace std; 

// Fonction template prenant en parametre deux valeurs 

// et un foncteur : 

template <class T, class F> 

T applique (T i, T j, F foncteur) 

{ 

// Applique l'operateur fonctionnel au foncteur 

// avec comme arguments les deux premiers parametres : 

return foncteur (i, j); 

} 

int main (void) 
{ 

// Construit le foncteur de somme : 

plus<int> f oncteur_plus; 

// Utilise ce foncteur pour faire faire une addition 

// a la fonction "applique" : 

cout << applique (2, 3, f oncteur_plus ) << endl; 

return 0; 
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} 

Dans l'exemple precedent, la fonction template applique prend en troisieme parametre un fonc- 
teur et l'utilise pour realiser l'operation a faire avec les deux premiers parametres. Cette fonction 
ne peut theoriquement etre utilisee qu'avec des objets disposant d'un operateur fonctionnel ' ( ) ', et 
pas avec des fonctions normales. La bibliotheque standard fournit done les adaptateurs suivants, qui 
permettent de convertir respectivement n'importe quelle fonction unaire ou binaire en foncteur : 

template <class Arg, class Result> 
class pointer_to_unary_f unction : 

public unary_f unction<Arg, Result> 
{ 
public : 

explicit pointer_to_unary_function (Result (*fonction) (Arg)); 

Result operator () (Arg argumentl) const; 

}; 

template <class Argl, Arg2, Result> 
class pointer_to_binary_f unction : 

public binary_f unction<Argl, Arg2, Result> 
{ 
public : 

explicit pointer_to_binary_f unction (Result (*fonction) (Argl, Arg2 ) ) ; 

Result operator () (Argl argumentl, Arg2 argument2) const; 

}; 

template <class Arg, class Result> 
pointer_to_unary_f unction < Arg, Result> 
ptr_fun (Result (*fonction) (Arg)); 

template <class Arg, class Result> 
pointer_to_binary_f unction<Argl, Arg2, Result> 
ptr_fun (Result (*fonction) (Argl, Arg2)); 

Les deux surcharges de la fonction template ptr_fun permettent de faciliter la construction d'un 
foncteur unaire ou binaire a partir du pointeur d'une fonction du meme type. 

Exemple 13-7. Adaptateurs de fonctions 

#include <iostream> 
#include <functional> 

using namespace std; 

template <class T, class F> 

T applique (T i, T j, F foncteur) 

{ 

return foncteur (i, j); 



// Fonction classique effectuant une multiplication 

int mul(int i, int j) 

{ 

return i * j; 



int main (void) 
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II Utilise un adaptateur pour transformer le pointeur 
// sur la fonction mul en foncteur : 
cout << applique (2, 3, ptr_f un (Smul ) ) << endl; 
return 0; 



Note : En realite le langage C++ est capable d'appeler une fonction directement a partir de son 
adresse, sans dereferencement. De plus le nom d'une fonction represents toujours sont adresse, 
et est done converti implicitement par le compilateur en pointeur de fonction. Par consequent, il 
est tout a fait possible d'utiliser la fonction template applique avec une autre fonction a deux 
parametres, comme dans I'appel suivant : 

applique (2, 3, mul); 

Cependant, cette ecriture provoque la conversion implicite de I'identificateur mui en pointeur de 
fonction prenant deux entiers en parametres et renvoyant un entier, d'une part, et I'appel de la 
fonction mui par I'intermediaire de son pointeur sans dereferencement dans la fonction template 
applique d'autre part. Cette ecriture est done acceptee par le compilateur par tolerance, mais 
n'est pas rigoureusement exacte. 



La bibliotheque standard C++ definit egalement des adaptateurs pour les pointeurs de methodes non 
statiques de classes. Ces adaptateurs se construisent comme les adaptateurs de fonctions statiques 
classiques, a ceci pres que leur constructeur prend un pointeur de methode de classe et non un pointeur 
de fonction normale. lis sont declares de la maniere suivante dans l'en-tete functional : 

template <class Result, class Class> 
class mem_fun_t : 

public unary_f unction<Class *, Result> 
{ 
public : 

explicit mem_fun_t (Result (Class :: *methode) ( ) ) ; 

Result operator!) (Class *pObjet); 
}; 

template <class Result, class Class, class Arg> 
class mem_funl_t : 

public binary_f unction<Class *, Arg, Result> 
{ 
public : 

explicit mem_funl_t (Result (Class :: *methode) (Arg)); 

Result operator () (Class *pObjet, Arg argument); 

}; 

template <class Result, class Class> 
class mem_f un_ref_t : 

public unary_function<Class, Result> 
{ 
public : 

explicit mem_fun_ref_t (Result (Class :: *methode) ()); 

Result operator () (Class Sobjet); 
}; 
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template <class Result, class Class, class Arg> 
class mem_f unl_ref_t : 

public binary_f unction<Class, Arg, Result> 
{ 
public : 

explicit mem_funl_ref_t (Result (Class :: *methode) (Arg)); 

Result operator () (Class Sobjet, Arg argument); 
}; 

template <class Result, class Class> 

mem_f un_t<Result , Class> mem_fun (Result (Class :: *methode) ()); 

template <class Result, class Class, class Arg> 
mem_funl_t<Result , Class> mem_fun (Result (Class :: *methode) (Arg)); 

template <class Result, class Class> 

mem_f un_ref_t<Result , Class> mem_fun_ref (Result (Class :: *methode) ()); 

template <class Result, class Class, class Arg> 
mem_funl_ref_t<Result , Class> 

mem_fun_ref (Result (Class :: *methode) (Arg)); 



Comme vous pouvez le constater d'apres leurs declarations les operateurs fonctionnels de ces adap- 
tateurs prennent en premier parametre soit un pointeur sur l'objet sur lequel le foncteur doit travailler 
(adaptateurs mem_fun_t et mem_funl_t), soit une reference sur cet objet (adaptateurs mem_fun_ref_t 
et mem_funl_ref_t). Le premier parametre de ces foncteurs est done reserve pour l'objet sur lequel 
la methode encapsulee doit etre appelee. 

En fait, la liste des adaptateurs presentee ci-dessus n'est pas exhaustive. En effet, chaque adaptateur 
presente est double d'un autre adaptateur, capable de convertir les fonctions membres const. II existe 
done huit adaptateurs au total permettant de construire des foncteurs a partir des fonctions membres 
de classes. Pour diminuer cette complexite, la bibliotheque standard definit plusieurs surcharges pour 
les fonctions mem_fun et mem_fun_ref, qui permettent de construire tous ces foncteurs plus facile- 
ment, sans avoir a se soucier de la nature des pointeurs de fonction membre utilises. II est fortement 
recommande de les utiliser plutot que de chercher a construire ces objets manuellement. 



13.5.2. Predicats et foncteurs d 'operateurs logiques 

Les foncteurs qui peuvent etre utilises dans une expression logique constituent une classe particuliere : 
les predicats. Un predicat est un foncteur dont l'operateur fonctionnel renvoie un booleen. Les predi- 
cats ont done un sens logique, et caracterisent une propriete qui ne peut etre que vraie ou fausse. 

La bibliotheque standard fournit des predicats predefinis qui effectuent les operations logiques 
des operateurs logiques de base du langage. Ces predicats sont egalement declares dans l'en-tete 

functional : 

template <class T> 
struct logical_and : 

binary_f unction<T, T, bool> 
{ 

bool operator () (const T soperandel, const T &operande2) const; 
}; 

template <class T> 
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struct logical_or : 

binary_f unction<T, T, bool> 
{ 

bool operator () (const T soperandel, const T &operande2) const; 



Ces foncteurs fonctionnent exactement comme les foncteurs vus dans la section precedente. 

La bibliotheque standard definit aussi deux foncteurs particuliers, qui permettent d'effectuer la nega- 
tion d'un autre predicat. Ces deux foncteurs travaillent respectivement sur les predicats unaires et sur 
les predicats binaires : 

template <class Predicate> 
class unary_negate : 

public unary_f unction<typename Predicate :: argument_type, bool> 
{ 
public : 

explicit unary_negate (const Predicate Spredicat); 

bool operator () (const argument_type Sargument) const; 

}; 

template <class Predicate> 
class binary_negate : 

public binary_f unction<typename Predicate :: first_argument_type, 
typename Predicate :: second_argument_type, bool> 
{ 
public : 

explicit binary_negate (const Predicate Spredicat); 
bool operator () (const f irst_argument_type Sargumentl, 
const second_argument_type &argument2) const; 

}; 

template <class Predicate> 

unary_negate<Predicate> notl (const Predicate Spredicat) ; 

template <class Predicate> 

binary_negate<Predicate> not2 (const Predicate Spredicat); 

Les fonctions not 1 et not 2 servent a faciliter la construction d'un predicat inverse pour les predicats 
unaires et binaires. 



13.5.3. Foncteurs reducteurs 

Nous avons vu que la bibliotheque standard ne travaillait qu'avec des foncteurs prenant au plus deux 
arguments. Certains algorithmes n'utilisant que des foncteurs unaires, ils ne sont normalement pas 
capables de travailler avec les foncteurs binaires. Toutefois, si un des parametres d'un foncteur binaire 
est fixe a une valeur donnee, celui-ci devient unaire, puisque seul le deuxieme parametre peut varier. 
II est done possible d'utiliser des foncteurs binaires meme avec des algorithmes qui n'utilisent que 
des foncteurs unaires, a la condition de fixer l'un des parametres. 

La bibliotheque standard definit des foncteurs speciaux qui permettent de transformer tout foncteur 
binaire en foncteur unaire a partir de la valeur de l'un des parametres. Ces foncteurs effectuent une 
operation dite de reduction car ils reduisent le nombre de parametres du foncteur binaire a un. Pour 
cela, ils definissent un operateur fonctionnel a un argument, qui applique l'operateur fonctionnel du 
foncteur binaire a cet argument et a une valeur fixe qu'ils memorisent en donnee membre. 
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Ces foncteurs reducteurs sont declares, comme les autres foncteurs, dans l'en-tete f onctional : 

template <class Operation> 
class binderlst : 

public unary_f unction<typename Operation :: second_argument_type, 
typename Operation :: result_type> 
{ 
protected: 

Operation op; 

typename Operation :: first_argument_type value; 
public : 

binderlst (const Operation Sfoncteur, 

const typename Operation :: first_argument_type Svaleur) ; 

result_type operator!) (const argument_type Svariable) const; 

}; 

template <class Operation> 
class binder2nd : 

public unary_f unction<typename Operation :: first_argument_type, 
typename Operation :: result_type> 
{ 
protected: 

Operation op; 

typename Operation :: second_argument_type value; 
public : 

binder2nd (const Operation Sfoncteur, 

const typename Operation :: second_argument_type Svaleur); 

result_type operator () (const argument_type Svariable) const; 

}; 

template <class Operation, class T> 

binderlst<Operation> bindlst (const Operation Sfoncteur, const T Svaleur); 

template <class Operation, class T> 

binder2nd<Operation> bind2nd (const Operation Sfoncteur, const T Svaleur); 



II existe deux jeux de reducteurs, qui permettent de reduire les foncteurs binaires en fixant respec- 
tivement leur premier ou leur deuxieme parametre. Les reducteurs qui figent le premier parametre 
peuvent etre construits a l'aide de la fonction template bindlst, et ceux qui figent la valeur du 
deuxieme parametre peuvent l'etre a l'aide de la fonction bind2nd. 

Exemple 13-8. Reduction de foncteurs binaires 

#include <iostream> 
#include <functional> 

using namespace std; 

// Fonction template permettant d' appliquer une valeur 

// a un foncteur unaire. Cette fonction ne peut pas 

// etre utilisee avec un foncteur binaire. 

template <class Foncteur> 

typename Foncteur :: result_type applique ( 

Foncteur f, 

typename Foncteur :: argument_type valeur) 
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{ 

return f (valeur) ; 



int main (void) 
{ 

// Construit un foncteur binaire d' addition d'entiers : 

plus<int> plus_binaire; 

int i; 

for (i = 0; i < 10; ++i) 

{ 

// Reduit le foncteur plus_binaire en fixant son 

// premier parametre a 35. Le foncteur unaire obtenu 

// est ensuite utilise avec la fonction applique : 

cout << applique (bindlst (plus_binaire, 35), i) << endl; 

} 

return 0; 



13.6. Gestion personnalisee de la memoire : les allocateurs 

L'une des plus grandes forces de la bibliotheque standard est de donner aux programmeurs le controle 
total de la gestion de la memoire pour leurs objets. En effet, les conteneurs peuvent etre amenes a 
creer un grand nombre d'objets, dont le comportement peut etre tres different selon leur type. Si, dans 
la majorite des cas, la gestion de la memoire effectuee par la bibliotheque standard convient, il peut 
parfois etre necessaire de prendre en charge soi-meme les allocations et les liberations de la memoire 
pour certains objets. 

La bibliotheque standard utilise pour cela la notion d' alloc ate ur. Un allocateur est une classe C++ 
disposant de methodes standards que les algorithmes de la bibliotheque peuvent appeler lorsqu'elles 
desirent allouer ou liberer de la memoire. Pour cela, les conteneurs de la bibliotheque standard C++ 
prennent tous un parametre template representant le type des allocateurs memoire qu'ils devront 
utiliser. Bien entendu, la bibliotheque standard fournit un allocateur par defaut, et ce parametre tem- 
plate prend par defaut la valeur de cet allocateur. Ainsi, les programmes qui ne desirent pas specifier 
un allocateur specifique pourront simplement ignorer ce parametre template. 

Les autres programmes pourront definir leur propre allocateur. Cet allocateur devra evidemment four- 
nir toutes les fonctionnalites de 1' allocateur standard, et satisfaire a quelques contraintes particu- 
lieres. L'interface des allocateurs est fournie par la declaration de l'allocateur standard, dans l'en-tete 

memory : 

template <class T> 
class allocator 
{ 
public : 

typedef size_t size_type; 

typedef ptrdiff_t dif ference_type; 

typedef T *pointer; 

typedef const T *const_pointer; 

typedef T sreference; 

typedef const T &const_ref erence; 

typedef T value_type; 

template <class U> 

struct rebind 
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typedef allocator<U> other; 



allocator () throw (); 

allocator (const allocator &) throw (); 

template <class U> 

allocator (const allocator<U> &) throw (); 

-allocator () throw (); 

pointer address (reference objet); 

const_pointer address (const_ref erence objet) const; 

pointer allocate ( size_type nombre, 

typename allocator<void> : : const_pointer indice) ; 
void deallocate (pointer adresse, size_type nombre); 
size_type max_size() const throw (); 
void construct (pointer adresse, const T Svaleur) ; 
void destroy (pointer adresse); 
}; 

// Specialisation pour le type void pour eliminer les references : 

template <> 

class allocator<void> 

{ 

public : 

typedef void *pointer; 

typedef const void *const_pointer; 

typedef void value_type; 

template <class U> 

struct rebind 

{ 

typedef allocator<U> other; 

}; 
}; 

Vous noterez que cet allocateur est specialise pour le type void, car certaines methodes et certains 
typedef n'ont pas de sens pour ce type de donnee. 

Le role de chacune des methodes des allocateurs est tres clair et n'appelle pas beaucoup de commen- 
taires. Les deux surcharges de la methode address permettent d'obtenir l'adresse d'un objet alloue 
par cet allocateur a partir d'une reference. Les methodes allocate et deallocate permettent res- 
pectivement de realiser une allocation de memoire et la liberation du bloc correspondant. La methode 
allocate prend en parametre le nombre d'objets qui devront etre stockes dans le bloc a allouer et 
un pointeur fournissant des informations permettant de determiner l'emplacement oil l'allocation doit 
se faire de preference. Ce dernier parametre peut ne pas etre pris en compte par 1' implementation de 
la bibliotheque standard que vous utilisez et, s'il Test, son role n'est pas specifie. Dans tous les cas, 
s'il n'est pas nul, ce pointeur doit etre un pointeur sur un bloc deja alloue par cet allocateur et non 
encore libere. La plupart des implementations chercheront a allouer un bloc adjacent a celui fourni 
en parametre, mais ce n'est pas toujours le cas. De meme, notez que le nombre d'objets specifie a la 
methode deallocate doit exactement etre le meme que celui utilise pour l'allocation dans l'appel 
correspondant a allocate. Autrement dit, l'allocateur ne memorise pas lui-meme la taille des blocs 
memoire qu'il a fourni. 

Note : Le pointeur passe en parametre a la methode allocate n'est ni libere, ni realloue, ni 
reutilise par l'allocateur. II ne s'agit done pas d'une modification de la taille memoire du bloc fourni 
en parametre, et ce bloc devra toujours etre libere independamment de celui qui sera alloue. 
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Ce pointeur n'est utilise par les implementations que comme un indice fourni a I'allocateur afin 
d'optimiser les allocations de blocs dans les algorithmes et les conteneurs internes. 

La methode allocate peut lancer I'exception bad_alloc en cas de manque de memoire ou si le 
nombre d'objets specifies en parametre est trap gros. Vous pourrez obtenir le nombre maximal 
que la methode allocate est capable d'accepter grace a la methode max_size de I'allocateur. 



Les deux methodes construct et destroy permettent respectivement de construire un nouvel ob- 
jet et d'en detruire un a l'adresse indiquee en parametre. Elles doivent etre utilisees lorsqu'on desire 
appeler le constructeur ou le destructeur d'un objet stocke dans une zone memoire allouee par cet al- 
locateur et non par les operateurs new et delete du langage (rappelons que ces operateurs effectuent 
ce travail automatiquement). Pour effectuer la construction d'un nouvel objet, construct utilise 
l'operateur new avec placement, et pour le detruire, destroy appelle directement le destructeur de 
F objet. 

Note : Les methodes construct et destroy n'effectuent pas I'allocation et la liberation de la 
memoire elles-memes. Ces operations doivent etre effectuees avec les methodes allocate et 
deallocate de I'allocateur. 



Exemple 13-9. Utilisation de I'allocateur standard 

#include <iostream> 
#include <memory> 

using namespace std; 

class A 
{ 
public : 

A() ; 

A (const A &) ; 

~A() ; 



A: :A() 
{ 

cout << "Constructeur de A" << endl; 
} 

A: :A (const A S) 
{ 

cout << "Constructeur de copie de A" << endl; 
} 

A: :~A() 
{ 

cout << "Destructeur de A" << endl; 
} 

int main (void) 
{ 

// Construit une instance de I'allocateur standard pour la classe A 

allocator<A> A_alloc; 
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II Alloue l'espace necessaire pour stocker cinq instances de A : 
allocator<A> : :pointer p = A_alloc . allocate (5) ; 

// Construit ces instances et les initialise : 

A init; 

int i; 

for (i=0; i<5; ++i) 

A_alloc . construct (p+i, init); 
// Detruit ces instances : 
for (i=0; i<5; ++i) 

A_alloc .destroy(p+i) ; 

// Reconstruit ces 5 instances : 
for (i=0; i<5; ++i) 

A_alloc . construct (p+i, init); 
// Destruction finale : 
for (i=0; i<5; ++i) 

A_alloc .destroy(p+i) ; 

// Libere la memoire : 
A_alloc . deallocate (p, 5); 
return 0; 
} 

Vous voyez ici l'interet que peut avoir les allocateurs de la bibliotheque standard. Les algorithmes 
peuvent controler explicitement la construction et la destruction des objets, et surtout les dissocier 
des operations d' allocation et de liberation de la memoire. Ainsi, un algorithme devant effectuer 
beaucoup d'allocations memoire pourra, s'il le desire, effectuer ces allocations une bonne fois pour 
toutes grace a l'allocateur standard, et n' effectuer les operations de construction et de destruction des 
objets que lorsque cela est necessaire. En procedant ainsi, le temps passe dans les routines de gestion 
de la memoire est elimine et 1' algorithme est d'autant plus performant. Inversement, un utilisateur 
experimente pourra definir son propre allocateur memoire adapte aux objets qu'il voudra stocker 
dans un conteneur. En imposant au conteneur de la bibliotheque standard d'utiliser cet allocateur 
personnalise, il obtiendra des performances optimales. 

La definition d'un allocateur maison consiste simplement a implementer une classe template dispo- 
sant des memes methodes et types que ceux definis par l'allocateur allocator. Toutefois, il faut savoir 
que la bibliotheque impose des contraintes sur la semantique de ces methodes : 

• toutes les instances de la classe template de l'allocateur permettent d'acceder a la meme me- 
moire. Ces instances sont done interchangeables et il est possible de passer de l'une a 1' autre a 
l'aide de la structure template rebind et de son typedef other. Notez que le fait d'encapsuler ce 
typedef dans une structure template permet de simuler la definition d'un type template ; 

• toutes les instances d'un allocateur d'un type donne permettent egalement d'acceder a la meme 
memoire. Cela signifie qu'il n'est pas necessaire de disposer d'une instance globale pour chaque 
allocateur, il suffit simplement de creer un objet local d'une des instances de la classe template 
de l'allocateur pour allouer et liberer de la memoire. Notez ici la difference avec la contrainte 
precedente : cette contrainte porte ici sur les objets instances des classes template instanciees, 
alors que la contrainte precedente portait sur les instances elles-memes de la classe template de 
l'allocateur ; 

• toutes les methodes de l'allocateur doivent s'executer dans un temps amorti constant (cela signifie 
que le temps d'execution de ces methodes est majore par une borne superieure fixe, qui ne depend 
pas du nombre d' allocation deja effectuees ni de la taille du bloc de memoire demande) ; 
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les methodes allocate et deallocate sont susceptibles d'utiliser les operateurs new et delete 
du langage. Ce n'est pas une obligation, mais cette contrainte signifie que les programmes qui 
redefinissent ces deux operateurs doivent etre capable de satisfaire les demandes de l'allocateur 
standard ; 

les types pointer, const_pointer, size_type et difference_type doivent etre egaux respectivement 
aux types T *, const T*, size_t et ptrdiff_t. En fait, cette contrainte n'est imposee que pour les 
allocateurs destines a etre utilises par les conteneurs de la bibliotheque standard, mais il est plus 
simple de la generaliser a tous les cas d'utilisation. 



Pour terminer ce tour d'horizon des allocateurs, sachez que la bibliotheque standard definit egalement 
un type iterateur special permettant de stacker des objets dans une zone de memoire non initialisee. 
Cet iterateur, nomme raw_storage_iterator, est de type Output et n'est utilise qu'en interne par la 
bibliotheque standard. De meme, la bibliotheque definit des algorithmes permettant d'effectuer des 
copies brutes de blocs memoire et d'autres manipulations sur les blocs alloues par les allocateurs. Ces 
algorithmes sont egalement utilises en interne, et ne seront done pas decrits plus en detail ici. 



13.7. Notion de complexity algorithmique 

En aucun endroit la norme C++ ne specifie la maniere de realiser une fonctionnalite. En effet, elle 
n' impose ni les structures de donnees, ni les algorithmes a utiliser. Les seules choses qui sont spe- 
cifiees par la norme sont les interfaces bien entendu (e'est-a-dire les noms des classes, des objets et 
les signatures des fonctions et des methodes) et la semantique des diverses operations realisables. Ce- 
pendant, la norme C++ ne permet pas de realiser toutes ces fonctionnalites n'importe comment, car 
elle impose egalement des contraintes de performances sur la plupart de ses algorithmes ainsi que sur 
les methodes des conteneurs. Ces contraintes sont exprimees generalement en terme de complexite 
algorithmique, aussi est-il necessaire de preciser un peu cette notion. 

Note : En pratique, les contraintes de complexite imposees par la bibliotheque standard sont tout 
simplement les plus fortes realisables. En d'autres termes, on ne peut pas faire mieux que les 
algorithmes de la bibliotheque standard. 



13.7.1. Generalites 

La nature des choses veut que plus un programme a de donnees a traiter, plus il prend du temps pour 
le faire. Cependant, certains algorithmes se comportent mieux que d'autres lorsque le nombre des 
donnees a traiter augmente. Par exemple, un algorithme mal ecrit peut voir son temps d'execution 
croitre exponentiellement avec la quantite de donnees a traiter, alors qu'un algorithme bien etudie 
aurait n'aurait ete plus lent que proportionnellement a ce meme nombre. En pratique, cela signifie que 
cet algorithme est tout simplement inutilisable lorsque le nombre de donnees augmente. Par exemple, 
le fait de doubler la taille de 1' ensemble des donnees a traiter peut engendrer un temps de calcul quatre 
fois plus long, alors que le temps d'execution de 1' algorithme bien ecrit n'aurait ete que du double 
seulement. Et si le nombre de donnees est triple et non double, cet algorithme demandera huit fois plus 
de temps, la ou le triple seulement est necessaire. Si Ton prend quatre fois plus de donnees, le temps 
sera multiplie par soixante-quatre. On voit clairement que les choses ne vont pas en s'ameliorant 
quand le nombre de donnees a traiter augmente... 

En realite, il est relativement rare de considerer le temps d'execution pour qualifier les performances 
d'un algorithme. En effet, le calcul du temps d'execution n'est pas toujours possible d'une part, parce 
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qu'il se base sur des parametres a priori inconnus, et n'est pas toujours ce qui est interessant au ni- 
veau du cout d'autre part. Pour illustrer ce dernier point, supposons que chaque operation effectuee 
par l'algorithme coute une certaine quantite d'energie. Dans certains contextes, il est plus important 
de s'interesser a l'energie depensee qu'au temps passe pour effectuer l'ensemble des traitements. Or 
certaines operations peuvent prendre relativement peu de temps, mais couter tres cher energetique- 
ment parlant, et 1' optimisation du temps d' execution ne donne pas forcement la meilleure solution. 
Un autre exemple est tout simplement celui de la lecture de secteurs sur un disque dur. La lecture de 
ces secteurs en soi ne prend pas tellement de temps, en revanche le deplacement de la tete de lecture 
se fait en un temps d'acces considerablement plus grand. Les algorithmes de gestion des entrees / 
sorties sur disque des systemes d' exploitation cherchent done naturellement a diminuer au maximum 
ces deplacements en reorganisant en consequence les requetes de lecture et d'ecriture. 

II est done generalement beaucoup plus simple de compter le nombre d'operations que les algo- 
rithmes effectuent lors de leur deroulement, car cette donnee est bien moins specifique au contexte 
d'utilisation de l'algorithme. Bien entendu, toutes les operations effectuees par un algorithme n'ont 
pas le meme cout dans un contexte donne, et de plus ce cout varie d'un contexte d'utilisation a un 
autre. La complexite d'un algorithme doit done toujours s'exprimer en nombre d'operations elemen- 
taires d'un certain type, etant entendu que les operations de ce type sont celles qui coutent le plus cher 
selon les criteres choisis... 

Remarquez que les operations qui sont realisees par un algorithme peuvent etre elles-memes relative- 
ment complexes. Par exemple, un algorithme qui applique une fonction sur chaque donnee a traiter 
peut utiliser une fonction inimaginablement complexe. Cependant, cela ne nous interesse pas dans la 
determination de la complexite de cet algorithme. Bien entendu, ce qu'il faut compter, e'est le nombre 
de fois que cette fonction est appelee, et la complexite de l'algorithme doit se calculer independam- 
ment de celle de cette fonction. L operation elementaire de l'algorithme est done ici tout simplement 
l'appel de cette fonction, aussi complexe soit-elle. 



13.7.2. Notions mathematiques de base et definition 

Le nombre des operations elementaires effectuees par un algorithme est une fonction directe du 
nombre de donnees a traiter. La complexite d'un algorithme est done directement reliee a cette 
fonction : plus elle croit rapidement avec le nombre de donnees a traiter, plus la complexite de 
l'algorithme est grande. 

En realite, la fonction exacte donnant le nombre d'operations elementaires effectuees par un algo- 
rithme n'est pas toujours facile a calculer. Cependant, il existe toujours une fonction plus simple qui 
dispose du meme comportement que la fonction du nombre d'operations de l'algorithme quand le 
nombre de donnees a traiter augmente. Cette « forme simplifiee » n'est en fait rien d'autre que la 
partie croissant le plus vite avec le nombre de donnees, car lorsque celui-ci tend vers l'infini, e'est 
elle qui devient predominante. Cela signifie que si Ton trace le graphe de la fonction, sa forme finit 
par ressembler a celle de sa forme simplifiee lorsque le nombre de donnees a traiter devient grand. 

La formulation complete de la fonction du nombre d'operations realisees par un algorithme n'importe 
done pas tant que cela, ce qui est interessant, e'est sa forme simplifiee. En effet, non seulement elle est 
plus simple (a exprimer, a manipuler et bien evidemment a retenir), mais en plus elle caracterise cor- 
rectement le comportement de l'algorithme sur les grands nombres. La complexite d'un algorithme 
est done, par definition, le terme preponderant dans la fonction donnant le nombre d'operations ele- 
mentaires effectuees par l'algorithme en fonction du nombre des donnees a traiter. 

Mathematiquement parlant, le fait que la forme simplifiee d'une fonction se comporte comme la 
fonction elle-meme a l'infini se traduit simplement en disant que les termes d'ordre inferieurs sont 
ecrases par le terme de premier ordre. Par consequent, si 1'on divise une fonction par l'autre, les 
termes d'ordre inferieur deviennent negligeables et la valeur du rapport tend a se stabiliser vers les 
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grand nombres. Autrement dit, il est possible de trouver deux constantes A et B positives et non nulles 
telles que, a partird'une certaine valeur de n, la triple inequation < Axc(n) < f(n) < Bxc(n), 
dans laquelle c (n) est la forme simplifiee de la fonction f (n) , est toujours verifiee. La fonction f (n) 
est done, en quelque sortes, encadree par deux « gendarmes » qui suivent le meme « trajet » : celui de 
la fonction c ( n ) . 

Note : Notez que cette formulation n'utilise pas le rapport des fonctions f (n) et c (n) directement. 
Elle est done toujours valide, meme lorsque ces deux fonctions sont nulles, ce qui aurait pose des 
problemes si Ton avait utilise un rapport. 



En fait, la limite inferieure Axe (n) ne nous interesse pas specialement. En effet, seul le cout maximal 
d'un algorithme est interessant, car s'il cofite moins cher que prevu, personne ne s'en plaindra... II est 
done courant d'utiliser une formulation plus simple et plus connue des mathematiciens, dans laquelle 
seule la derniere inequation est utilisee. On dit alors que la fonction f (n) est en grand O de c (n) (ce 
qui se note « o (c (n) ) »). Cela signifie qu'il existe une constante A telle que, pour toutes les valeurs 
de n superieures a une valeur suffisamment grande, la double inequation < f(n) < Axc(n) est 
toujours verifiee. 

Note : La notion de grand O permet done de donner une borne superieure de la complexite de 
la fonction. En fait, si f (n) est en o (c (n) ) , elle Test pour toutes les fonctions plus grandes que 
c (n) . Toutefois, en general, on cherche a determiner la plus petite fonction c (n) qui est un grand 

Ode f (n) . 

II est evident que si une fonction t (n) dispose d'une forme simplifiee c (n) , elle est en 0(c(n)). En 
effet, I'inequation superieure est toujours verifiee, on ne fait ici qu'ignorer la deuxieme inequation 
de la definition de la forme simplifiee. 



13.7.3. Interpretation pratique de la complexite 

Toutes ces notions peuvent vous paraitre assez abstraites, mais il est important de bien comprendre ce 
qu'elles signifient. II est done peut-etre necessaire de donner quelques exemples de complexite parmi 
celles que Ton rencontre le plus couramment. 

Tout d'abord, une complexite de 1 pour un algorithme signifie tout simplement que son cout 
d' execution est constant, quel que soit le nombre de donnees a traiter. Notez bien ici que Ton parle 
de cout d' execution et non de duree. Le cout est ici le nombre d'operations elementaires effectuees 
par cet algorithme. Les algorithmes de complexite 1 sont evidemment les plus interessants, mais ils 
sont helas assez rares ou tout simplement triviaux. 

Generalement, les algorithmes ont une complexite de n, leur cout d' execution est done proportionnel 
au nombre de donnees a traiter. C'est encore une limite acceptable, et generalement acceptee comme 
une consequence « logique » de 1' augmentation du nombre de donnees a traiter. Certains algorithmes 
sont en revanche nettement moins performants et ont une complexite en n 2 , soit le carre du nombre 
des elements a traiter. Cette fois, cela signifie que leur cout d'execution a tendance a croitre tres 
rapidement lorsqu'il y a de plus en plus de donnees. Par exemple, si Ton double le nombre de donnees, 
le cout d'execution de l'algorithme ne double pas, mais quadruple. Et si Ton triple le nombre de 
donnees, ce cout devient neuf fois plus grand. Ne croyez pas pour autant que les algorithmes de ce 
type soient rares ou mauvais. On ne peut pas toujours, helas, faire autrement... 



231 



Chapitre 13. Services et notions de base de la bibliotheque standard 

II existe meme des algorithmes encore plus couteux, qui utilisent des exposants bien superieurs a 2. 
Inversement, certains algorithmes extremement astucieux permettent de reduire les complexites n ou 
n 2 en in (n) ou nxin (n) , ils sont done nettement plus efficaces. 

Note : La fonction in(n) est la fonction logarithmique, qui est la fonction inverse de 
I'exponentielle, bien connue pour sa croissance demesuree. La fonction logarithme evolue 
beaucoup moins vite que son argument, en I'occurrence n dans notre cas, et a done tendance a 
« ecraser » le cout des algorithmes qui I'ont pour complexite. 



Enfin, pour terminer ces quelques notions de complexite algorithmique, sachez que Ton peut evaluer 
la difficulte d'un probleme a partir de la complexite du meilleur algorithme qui permet de le resoudre. 
Par exemple, il a ete demontre que le tri d'un ensemble de n elements ne peut pas se faire en mieux 
que nxin (n) operations (et on sait le faire, ce qui est sans doute le plus interessant de l'affaire). 
Malheureusement, il n'est pas toujours facile de determiner la complexite d'un probleme. II existe 
meme toute une classe de problemes extremement difficiles a resoudre pour lesquels on ne sait meme 
pas si leur solution optimale est polynomiale ou non. En fait, on ne sait les resoudre qu'avec des 
algorithmes de complexite exponentielle (si vous ne savez pas ce que cela signifie, en un mot, cela 
veut dire que e'est une veritable catastrophe). Cependant, cela ne veut pas forcement dire qu'on ne 
peut pas faire mieux, mais tout simplement qu'on n'a pas pu trouver une meilleure solution, ni meme 
prouver qu'il y en avait une ! Toutefois, tous ces problemes sont lies et, si on trouve une solution 
polynomiale pour l'un d'entre eux, on saura resoudre aussi facilement tous ses petits camarades. Ces 
problemes appartiennent tous a la classe des problemes dits « NP-complets ». 
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Le C++ etant un langage base sur le C, il souffre des memes limitations concernant les types de 
donnees avances que celui-ci. Pour pallier cet inconvenient, la bibliotheque standard C++ definit 
des types complementaires sous forme de classes C++, eventuellement template, et permettant de 
satisfaire aux besoins les plus courants. Parmi ces types, on notera avant tout le type basic_string, 
qui permet de manipuler les chaines de caracteres de maniere plus simple et plus sure qu'avec des 
pointeurs et des tableaux de caracteres. Mais la bibliotheque standard definit egalement des classes 
utilitaires qui permettent de manipuler les autres types plus facilement, ainsi que des types capables 
d'utiliser toutes les ressources de la machine pour les calculs numeriques avances. 



14.1. Les chaines de caracteres 

La classe template basic_string de la bibliotheque standard, declaree dans l'en-tete string, facilite 
le travail du programmeur et permet d'ecrire du code manipulant des textes de maniere beaucoup 
plus sure. En effet, cette classe encapsule les chaines de caracteres C classiques et fournissent des 
services extremement interessants qui n'etaient pas disponibles auparavant. En particulier, la classe 
basic_string dispose des caracteristiques suivantes : 



compatibilite quasi-totale avec les chaines de caracteres C standards ; 

gestion des chaines a taille variable ; 

prise en charge de l'allocation dynamique de la memoire et de sa liberation en fonction des besoins 
et de la taille des chaines manipulees ; 

definition des operateurs de concatenation, de comparaison et des principales methodes de re- 
cherche dans les chaines de caracteres ; 

integration totale dans la bibliotheque standard, en particulier au niveau des flux d' entree / sortie. 



Comme il l'a ete dit plus haut, la classe basic_string est une classe template. Cela signifie qu'elle 
est capable de prendre en charge des chaines de n'importe quel type de caractere. Pour cela, elle ne 
se base que sur la classe des traits du type de caractere manipule. II est done parfaitement possible 
de l'utiliser avec des types definis par l'utilisateur, pourvu que la classe des traits des caracteres 
soit definie pour ces types. Bien entendu, la classe basic_string peut etre utilisee avec les types de 
caracteres du langage, a savoir char et wchar_t. 

Les declarations de l'en-tete string sont essentiellement les suivantes : 

template <class charT, class traits = char_traits<charT>, 

class Allocator = allocator<charT> > 
class basic_string 
{ 
public : 

// Types 

typedef traits traits_type; 

typedef typename traits :: char_type value_type; 

typedef Allocator allocator_type; 

typedef typename Allocator :: size_type size_type; 

typedef typename Allocator :: dif ference_type dif f erence_type; 

typedef typename Allocator :: reference ref erence_type; 

typedef typename Allocator :: const_reference const_ref erence; 

typedef typename Allocator : :pointer pointer; 
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typedef typename Allocator :: const_pointer const_pointer; 

// Constante utilisee en interne et representant la valeur maximale 

// du type size_type : 

static const size_type npos = static_cast<size_type> (-1) ; 

// Constructeurs et destructeur : 

explicit basic_string (const Allocator sallocateur = Allocator ()) ; 

basic_string (const basic_string Ssource, size_type debut = 0, 

size_type fin = npos, const Allocator sallocateur = Allocator ()) ; 
basic_string (const charT *chaine, size_type nombre, 

const Allocator sallocateur = Allocator ()) ; 
basic_string (const charT *chaine, 

const Allocator sallocateur = Allocator ()) ; 
basic_string (size_type nombre, charT caractere, 

const Allocator sallocateur = Allocator ()) ; 
template <class InputIterator> 
basic_string (Input Iterator debut, Inputlterator fin, 

const Allocator sallocateur = Allocator ()) ; 
~basic_string ( ) ; 

// Iterateurs : 

typedef type_prive iterator; 

typedef type_prive const iterator; 

typedef std: : reverse_iterator<iterator> reverse_iterator; 

typedef std: : reverse_iterator<const_iterator> const_reverse_iterator; 

iterator begin (); 

const_iterator begin () const; 

iterator end ( ) ; 

const_iterator end ( ) const; 

reverse_iterator rbegin(); 

const_reverse_iterator rbegin() const; 

reverse_iterator rend ( ) ; 

const_reverse_iterator rend ( ) const; 

// Accesseurs : 

size_type sized const; 

size_type length () const; 

size_type max_size() const; 

size_type capacity () const; 

bool empty () const; 

allocator_type get_allocator ( ) const; 

// Manipulateurs : 

void resize ( size_type taille, charT caractere); 

void resize (size_type taille); 

void reserve (size_type taille = 0); 

// Acces aux donnees de la chaine : 

const_ref erence operator [] (size_type index) const; 
reference operator [] (size_type index); 
const_ref erence at (size_type index) const; 
reference at (size_type index); 
const charT *c_str() const; 
const charT *data() const; 

size_type copy (charT *destination, size_type taille, 
size_type debut = 0) const; 
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basic_string substr ( size_type debut = 0, size_type taille = npos) const; 

// Affectation : 

basic_string Soperator= (const basic_string Ssource); 
basic_string Soperator= (const charT *source); 
basic_string Soperator= (charT caractere) ; 
basic_string Sassign (const basic_string Ssource); 
basic_string Sassign (const basic_string Ssource, 

size_type position, size_type nombre); 
basic_string Sassign (const charT *chaine, size_type nombre); 
basic_string Sassign (const charT *chaine) ; 
basic_string sassign (size_type nombre, charT caractere); 
template <class InputIterator> 
basic_string Sassign ( Input Iterator debut, Inputlterator fin); 

// Concatenation et ajout : 

basic_string Soperator+= (const basic_string Ssource) ; 
basic_string Soperator+= (const charT *chaine) ; 
basic_string soperator+= (charT caractere); 
basic_string Sappend (const basic_string Ssource); 
basic_string Sappend (const basic_string Ssource, 

size_type position, size_type nombre); 
basic_string Sappend (const charT *chaine, size_type nombre); 
basic_string Sappend (const charT *chaine); 
basic_string sappend (size_type nombre, charT caractere); 
template <class InputIterator> 
basic_string Sappend ( Input Iterator debut, Inputlterator fin); 

// Insertion et extraction : 

basic_string Sinsert (size_type position, const basic_string Ssource) ; 

basic_string Sinsert (size_type position, const basic_string Ssource, 

size_type debut, size_type nombre); 

basic_string Sinsert (size_type position, const charT *chaine, 

size_type nombre) ; 

basic_string Sinsert (size_type position, const charT *chaine); 

basic_string Sinsert (size_type position, size_type nombre, 

charT caractere) ; 
iterator insert (iterator position, charT caractere = charT ()); 

void insert (iterator position, size_type nombre, charT caractere); 
template <class InputIterator> 

void insert (iterator position, Inputlterator debut, Inputlterator fin); 

// Suppression : 

basic_string serase ( size_type debut = 0, size_type fin = npos) ; 

iterator erase ( iterator position); 

iterator erase ( iterator debut, iterator fin); 

void clear ( ) ; 

// Remplacement et echange : 

basic_string replace (size_type position, size_type longueur, 

const basic_string S remplacement ) ; 
basic_string replace (size_type position, size_type longueur, 

const basic_string sremplacement , size_type debut, 

size_type taille) ; 
basic_string Sreplace ( size_type position, size_type longueur, 

const charT *remplacement , size_type taille); 
basic_string Sreplace ( size_type position, size_type longueur, 
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const charT *remplacement ) ; 
basic_string Sreplace ( size_type position, size_type longueur, 

size_type nombre, charT caractere) ; 
basic_string sreplace (iterator debut, iterator fin, 

const basic_string Sremplacement ) ; 
basic_string sreplace (iterator debut, iterator fin, 

const charT *remplacement , size_type taille); 
basic_string sreplace (iterator debut, iterator fin, 

const charT *remplacement ) ; 
basic_string sreplace (iterator debut, iterator fin, 

size_type nombre, charT caractere) ; 
template <class InputIterator> 
basic_string sreplace (iterator debut, iterator fin, 

Input Iterator debut_remplacement , Inputlterator f in_remplacement ) ; 
void swap (basic_string<charT, traits, Allocator> Schaine) ; 

// Comparaison : 

int compare (const basic_string Schaine) const; 

int compare (size_type debutl, size_type longueurl, 

const basic_string Schaine, 

size_type debut2, size_type longueur2) const; 
int compare (const charT *chaine) const; 
int compare ( size_type debut, size_type longueur, const charT *chaine, 

size_type taille = npos) const; 

// Recherche : 

size_type find (const basic_string Smotif, 

size_type position = 0) const; 
size_type find (const charT *motif, size_type position, 

size_type taille) const; 
size_type find (const charT *motif, size_type position = 0) const; 
size_type find (charT caractere, size_type position = 0) const; 
size_type rfind (const basic_string Smotif, 

size_type position = npos) const; 
size_type rfind (const charT *motif, size_type position, 

size_type taille) const; 
size_type rfind (const charT *motif, size_type position = npos) const; 
size_type rfind (charT caractere, size_type position = npos) const; 
size_type find_first_of (const basic_string Smotif, 

size_type position = 0) const; 
size_type find_first_of (const charT *motif, size_type position, 

size_type taille) const; 
size_type find_first_of (const charT *motif, 

size_type position = 0) const; 
size_type find_first_of (charT caractere, size_type position = 0) const; 
size_type f ind_last_of (const basic_string Smotif, 

size_type position = npos) const; 
size_type f ind_last_of (const charT *motif , size_type position, 

size_type taille) const; 
size_type f ind_last_of (const charT *motif , 

size_type position = npos) const; 
size_type find_last_of (charT caractere, 

size_type position = npos) const; 
size_type f ind_f irst_not_of (const basic_string Smotif, 

size_type position = 0) const; 
size_type f ind_f irst_not_of (const charT *motif , size_type position, 

size_type taille) const; 
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size_type f ind_f irst_not_of (const charT *motif , 

size_type position = 0) const; 
size_type f ind_f irst_not_of (charT caractere, 

size_type position = 0) const; 
size_type find_last_not_of (const basic_string Smotif, 

size_type position = npos) const; 
size_type find_last_not_of (const charT *motif, size_type position, 

size_type taille) const; 
size_type find_last_not_of (const charT *motif, 

size_type position = npos) const; 
size_type find_last_not_of (charT caractere, 

size_type position = npos) const; 



}; 



typedef basic_string<char> string; 
typedef basic_string<wchar_t> wstring; 

Les operateurs de concatenation, de comparaison et de serialisation dans les flux d'entree / sortie 
sont egalement dermis dans cet en-tete et n'ont pas ete reportes ici par souci de clarte. Comme vous 
pouvez le voir, la classe basic_string dispose d'un grand nombre de methodes. Nous allons a present 
les detailler dans les paragraphes suivants. 

La bibliotheque standard definit deux types chaines de caracteres pour les types standards de carac- 
teres du langage : le type string pour les char, et le type wstring pour les wchar_t. En pratique, ce seront 
done ces types qui seront utilises dans les programmes. Les exemples de la suite de ce document uti- 
liseront done le type string, mais vous etes libre d'utiliser des instances de la classe basic_string pour 
d'autres types de caracteres. 

14.1.1. Construction et initialisation d'une chame 

La maniere la plus simple de construire une basic_string est simplement de la declarer, sans para- 
metres. Cela a pour consequence d'appeler le constructeur par defaut, et d'initialiser la chaine a la 
chaine vide. 

En revanche, si vous desirez initialiser cette chaine, plusieurs possibilites s'offrent a vous. Outre le 
constructeur de copie, qui permet de copier une autre basic_string, il existe plusieurs surcharges du 
constructeur permettant d'initialiser la chaine de differentes manieres. Le constructeur le plus utilise 
sera sans aucun doute le constructeur qui prend en parametre une chaine de caracteres C classique : 

string chaine ( "Valeur initiale"); 

II existe cependant une variante de ce constructeur, qui prend en parametre le nombre de caracteres 
de la chaine source a utiliser pour 1' initialisation de la basic_string. Ce constructeur devra etre utilise 
dans le cas des tableaux de caracteres, qui contiennent des chaines de caracteres qui ne sont pas 
necessairement terminees par un caractere nul : 

string chaine ( "Valeur initiale", 6); 

La ligne precedente initialise la chaine chaine avec la chaine de caracteres "Valeur", car seuls les 
six premiers caracteres de la chaine d' initialisation sont utilises. 

II est egalement possible d'initialiser une basic_string avec une partie de chaine de caracteres seule- 
ment. Pour cela, il faut utiliser le constructeur template, qui prend en parametre un iterateur referen- 
cant le premier caractere a utiliser lors de l'initialisation de la basic_string et un iterateur referencant le 
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caractere suivant le dernier caractere a utiliser. Bien entendu, ces deux iterateurs sont de simples poin- 
teurs de caracteres si les caracteres devant servir a 1' initialisation sont dans une chaine de caracteres 
C ou dans un tableau de caracteres. Cependant, ce peut etre des iterateurs d'un conteneur quelconque, 
pourvu que celui-ci contienne bien une sequence de caracteres et que le deuxieme iterateur se trouve 
bien apres le premier dans cette sequence. Notez que le deuxieme iterateur ne reference pas le dernier 
caractere de la sequence d'initialisation, mais bien le caractere suivant. II peut done valoir la valeur 
de fin de l'iterateur du conteneur source. Ainsi, le code suivant : 

char *source = "Valeur initiale"; 
string s (source, source+6); 

a strictement le meme effet que celui de l'exemple precedent. 

Enfin, il existe un constructeur dont le but est d' initialiser une basic_string avec une suite de caracteres 
identiques d'une certaine longueur. Ce constructeur n'est reellement pas difficile a utiliser, puisqu'il 
suffit de lui fournir en parametre le nombre de caracteres que la basic_string devra contenir et la valeur 
du caractere qui devra etre repete dans cette chaine. 

Vous remarquerez que tous ces constructeurs prennent en dernier parametre une instance d'allocateur 
memoire a utiliser pour les operations d' allocation et de liberation de la memoire que la chaine est 
susceptible d' avoir a faire. Vous pouvez specifier une instance quelconque, ou utiliser la valeur par 
defaut fournie par les declarations des constructeurs. Cette valeur par defaut est tout simplement une 
instance temporaire de l'allocateur specifie en parametre template de la classe basic_string. Par 
defaut, cet allocateur est l'allocateur standard, pour lequel toutes les instances permettent d'acceder 
a la meme memoire. II n'est done pas necessaire de specifier l'instance a utiliser, puisqu'elles sont 
toutes fonctionnellement identiques. En pratique done, il est tres rare d' avoir a specifier un allocateur 
memoire dans ces constructeurs. 



14.1.2. Acces aux proprietes d'une chaine 

La classe basic_string fournit un certain nombre d'accesseurs permettant d'obtenir des informations 
sur son etat et sur la chaine de caracteres qu'elle contient. L'une des informations les plus interessantes 
est sans nul doute la longueur de cette chaine. Elle peut etre obtenue a l'aide de deux accesseurs, 
qui sont strictement equivalents : size et length. Vous pouvez utiliser l'un ou l'autre, selon votre 
convenance. Par ailleurs, si vous desirez simplement savoir si la basic_string est vide, vous pouvez 
appeler la methode empty. 

Note : Attention, contrairement a ce que son nom pourrait laisser penser, la methode empty ne 
vide pas la basic_string ! 



La taille maximale qu'une basic_string peut contenir est souvent directement liee a la quantite de 
memoire disponible, puisque la chaine de caracteres qu'elle contient est allouee dynamiquement. II 
n'y a done souvent pas beaucoup d'interet a obtenir cette taille, mais vous pouvez malgre tout le faire, 
grace a la methode max_size. 

La quantite de memoire reellement allouee par une basic_string peut etre superieure a la longueur 
de la chaine de caracteres contenue. En effet, la classe basic_string peut conserver une marge de 
manoeuvre, pour le cas ou la chaine devrait etre agrandie a la suite d'une operation particuliere. Cela 
permet de reduire les reallocations de memoire, qui peuvent etre tres couteuses lorsque la memoire 
se fragmente (la chaine doit etre recopiee vers un nouvel emplacement si un autre bloc memoire se 
trouve juste apres le bloc memoire a reallouer). Cette quantite de memoire peut etre obtenue a l'aide 
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de la methode capacity. Nous verrons comment reserver de la place memoire en prevision d'un 
redimensionnement ulterieur dans la section suivante. 

Dans le cas ou vous utiliseriez un allocateur different de l'allocateur par defaut, vous pouvez obtenir 
une copie de cet allocateur grace a la methode get_allocator. II est relativement rare d'avoir a 
utiliser cette methode. 



14.1.3. Modification de la taille des chaines 

Une fois qu'une basic_string a ete construite, il est possible de la modifier a posteriori pour la re- 
duire, l'agrandir ou augmenter sa capacite. Ces operations peuvent etre realisees a l'aide de methodes 
fournies a cet effet. 

La methode resize permet de modifier la taille de la chaine de caracteres stockee dans la ba- 
sic_string. Dans sa version la plus simple, elle prend en parametre la nouvelle taille que la chaine 
doit avoir. Si cette taille est inferieure a la taille courante, la chaine est tronquee. En revanche, si cette 
taille est superieure a la taille actuelle, la chaine est etendue et les nouveaux caracteres sont initiali- 
ses avec la valeur des caracteres definie par le constructeur par defaut de leur classe. Pour les types 
predefinis char et wchar_t, cette valeur est toujours le caractere nul. Les donnees stockees dans la 
basic_string represented done toujours la meme chaine de caracteres C, puisque ces chaines utilisent 
le caractere nul comme marqueur de fin de chaine. Ainsi, la longueur renvoyee par la methode size 
peut etre differente de la longueur de la chaine C contenue par la basic_string. 

Exemple 14-1. Redimensionnement d'une chaine 

#include <iostream> 
#include <string> 
#include <string.h> 

using namespace std; 

int main (void) 
{ 

string s ("123") ; 

s . resize (10) ; 

cout << s << endl; 

// La nouvelle taille vaut bien 10 : 

cout << "Nouvelle taille : " << s. length () << endl; 

// mais la longueur de la chaine C reste 3 : 

cout << "Longueur C : " << strlen (s . c_str ( ) ) << endl; 

return 0; 



Note : La methode c_str utilisee dans cet exemple sera decrite en detail dans la section suivante. 
Elle permet d'obtenir I'adresse de la chaine C stockee en interne dans la basic_string. 

La fonction strien quant a elle est une des fonctions de manipulation des chaines de caracteres 
de la bibliotheque C. Elle est definie dans le fichier d'en-tete string. h (que Ton ne confondra 
pas avec I'en-tete string de la bibliotheque standard C++), et renvoie la longueur de la chaine 
de caracteres qui lui est fournie en parametre. 



Si la valeur par defaut utilisee pour les caracteres complementaires dans la methode resize n'est 
pas celle qui est desiree, il faut en utiliser une autre version. Cette deuxieme version prend, en plus 
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de la nouvelle taille de la chaine de caracteres, le caractere de remplissage a utiliser pour le cas ou la 
nouvelle taille serait superieure a la taille initiale de la chaine : 

string s ("123") ; 
s . resize (10, ' a' ) ; 

Dans cet exemple, s contient finalement la chaine de caracteres "I23aaaaaaa". 

Nous avons vu precedemment que les basic_string etaient susceptibles d'allouer plus de memoire 
que necessaire pour stocker leurs donnees afin de limiter le nombre de reallocation memoire. Ce 
mecanisme est completement pris en charge par la bibliotheque, et le programmeur n'a en general 
pas a s'en soucier. Cependant, il peut exister des situations ou Ton sait a l'avance la taille minimale 
qu'une chaine doit avoir pour permettre de travailler dessus sans craindre de reallocations memoire 
successives. Dans ce cas, on a tout interet a fixer la capacite de la chaine directement a cette valeur, 
afin d'optimiser les traitements. Cela est realisable a l'aide de la methode reserve. Cette methode 
prend en parametre la capacite minimale que la basic_string doit avoir. La nouvelle capacite n'est pas 
forcement egale a ce parametre apres cet appel, car la basic_string peut allouer plus de memoire que 
demande. 

Exemple 14-2. Reservation de memoire dans une chaine 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string s; 

cout << s.capacityO << endl; 

s . reserve (15) ; 

s = "123"; 

cout << s.capacityO << endl; 

return 0; 
} 

Note : Les methodes resize et reserve peuvent effectuer une reallocation de la zone memoire 
contenant la chaine de caracteres. Par consequent, toutes les references sur les caracteres de 
la chaine et tous les iterateurs sur cette chaine deviennent invalide a la suite de leur execution. 



14.1.4. Acces aux donnees de la chaine de caracteres 

Les caracteres des basic_string peuvent etre accedes de nombreuses manieres. Premierement, la classe 
basic_string surcharge l'operateur d'acces aux elements d'un tableau, et Ton pourra les utiliser pour 
obtenir une reference a un des caracteres de la chaine a partir de son indice. Cet operateur n'est defini 
que pour les indices valides dans la chaine de caracteres, a savoir les indices variant de a la valeur 
retournee par la methode size de la chaine moins un : 

#include <iostream> 
#include <string> 
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using namespace std; 

int main (void) 
{ 

string s ( "azc" ) ; 

// Remplace le deuxieme caractere de la chaine par un 'b' : 

s[l] = 'b'; 

cout << s << endl; 

return ; 
} 



Lorsqu'il est applique a une basic_string constante, l'operateur tableau peut renvoyer la valeur du 
caractere dont 1'indice est exactement la taille de la chaine. II s'agit evidemment du caractere nul 
servant de marqueur de fin de chaine. En revanche, la reference renvoyee par cet operateur pour 
toutes les autres valeurs, ainsi que par l'operateur tableau applique aux chaines non constante pour 
le caractere de fin de chaine ne sont pas valides. Le comportement des programmes qui effectuent de 
tels acces est imprevisible. 

II existe une autre possibilite pour acceder aux caracteres d'une basic_string. II s'agit de la methode 
at. Contrairement a l'operateur tableau, cette methode permet d'effectuer un controle sur la validite 
de 1'indice utilise. Elle renvoie, comme l'operateur de tableau de la classe basic_string, la reference 
du caractere dont 1'indice est specifie en parametre. Cependant, elle effectue au prealable un controle 
sur la validite de cet indice, qui doit toujours etre strictement inferieur a la taille de la chaine. Dans le 
cas contraire, la methode at lance une exception out_of_range : 

#include <iostream> 
#include <string> 
tinclude <stdexcept> 

using namespace std; 

int main (void) 
{ 

string s ("01234") ; 

try 

{ 

s.at (5) ; 
} 

catch (const out_of_range &) 
{ 

cout << "Debordement ! " << endl; 
} 
return 0; 



La classe basic_string ne contient pas d' operateur de transtypage vers les types des chaines de carac- 
teres C classique, a savoir le type pointeur sur caractere et pointeur sur caractere constant. C'est un 
choix de conception, qui permet d'eviter les conversions implicites des basic_string en chaine C clas- 
sique, qui pourraient etre extremement dangereuses. En effet, ces conversions conduiraient a obtenir 
implicitement des pointeurs qui ne seraient plus valides des qu'une operation serait effectuee sur la 
basic_string source. Cependant, la classe basic_string fournit deux methodes permettant d'obtenir de 
tels pointeurs de maniere explicite. Le programmeur prend done ses responsabilites lorsqu'il utilise 
ces methodes, et est suppose savoir dans quel contexte ces pointeurs sont valides. 
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Ces deux methodes sont respectivement la methode data et la methode c_str. La premiere methode 
renvoie un pointeur sur les donnees de la basic_string. Ces donnees ne sont rien d' autre qu'un tableau 
de caracteres, dont la dimension est exactement la valeur retournee par la methode size ou par la 
methode length. Ce tableau peut contenir des caracteres de terminaison de chaine, si par exemple 
une telle valeur a ete ecrite explicitement ou a ete introduite suite a un redimensionnement de la 
chaine. La methode c_str en revanche retourne un pointeur sur la chaine de caracteres C contenue 
dans la basic_string. Contrairement aux donnees renvoyees par la methode data, cette chaine est 
necessairement terminee par un caractere de fin de chaine. Cette methode sera done utilisee partout 
ou Ton veut obtenir une chaine de caracteres C classique, mais elle ne devra pas etre utilisee pour 
acceder aux donnees situees apres ce caractere de fin de chaine. 

Exemple 14-3. Acces direct aux donnees d'une chaine 

#include <iostream> 
tinclude <string> 

using namespace std; 

int main (void) 
{ 

string s ("123456") ; 

// La chaine C est coupee au troisieme caractere : 

s [ 3 ] = ; 

cout << s.c_str() << endl; 

// Mais on peut quand mime obtenir les caracteres suivants : 

cout << s.data()[4] << s.data()[5] << endl; 

return 0; 



Notez que ces methodes renvoient des pointeurs sur des donnees constantes. Cela est normal, car il 
est absolument interdit de modifier les donnees internes a la basic_string qui a fourni ces pointeurs. 
Vous ne devez done en aucun cas essayer d'ecrire dans ces tableaux de caracteres, meme en faisant 
un transtypage au prealable. 

Enfin, la classe basic_string definit des iterateurs a acces aleatoires permettant d' acceder a ses donnees 
comme s'il s'agissait d'une chaine de caracteres standard. Les methodes begin et end permettent 
d' obtenir respectivement un iterateur sur le premier caractere de la chaine et la valeur de fin de ce 
meme iterateur. De meme, les methodes rbegin et rend permettent de parcourir les donnees de la 
basic_string en sens inverse. Prenez garde au fait que ces iterateurs ne sont valides que tant qu'aucune 
methode modifiant la chaine n'est appelee. 



14.1.5. Operations sur les chaines 

La classe basic_string fournit tout un ensemble de methodes permettant d'effectuer les operations les 
plus courantes sur les chaines de caracteres. C'est cet ensemble de methodes qui font tout l'interet 
de cette classe par rapport aux chaines de caracteres classiques du langage C, car elles prennent en 
charge automatiquement les allocations memoire et les copies de chaines que 1' implementation de ces 
fonctionnalites peut imposer. Ces operations comprennent 1' affectation et la concatenation de deux 
chaines de caracteres, 1' extraction d'une sous-chaine, ainsi que la suppression et le remplacement de 
caracteres dans une chaine. 
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14.1.5.1. Affectation et concatenation de chaines de caracteres 

Plusieurs surcharges de l'operateur d' affectation sont definies dans la classe basic_string. Ces 
surcharges permettent d'affecter une nouvelle valeur a une chaine, en remplacant eventuellement 
l'ancienne valeur. Dans le cas d'un remplacement, la memoire consommee par l'ancienne valeur est 
automatiquement reutilisee ou liberee si une reallocation est necessaire. Ces operateurs d' affectation 
peuvent prendre en parametre une autre basic_string, une chaine de caracteres C classique ou meme 
un simple caractere. Leur utilisation est done directe, il suffit simplement d'ecrire une affectation 
normale. 

II est impossible, avec l'operateur d' affectation, de fournir des parametres supplementaires comme 
ceux dont les constructeurs de la classe basic_string disposent par exemple. C'est pour cette raison 
qu'une autre methode, la methode assign, a ete definie pour permettre de faire des affectations plus 
complexes. 

Les premieres versions de ces methodes permettent bien entendu d'effectuer l'affectation d'une autre 
basic_string ou d'une chaine de caracteres C classique. Cependant, il est egalement possible de spe- 
cifier la longueur de la portion de chaine a copier en deuxieme parametre pour les chaines C, et la 
position ainsi que le nombre de caracteres a copier dans le cas d'une basic_string. II est egalement 
possible de reinitialiser une basic_string avec un caractere specifique, en donnant et le nombre de 
caracteres a dupliquer dans la chaine en premier parametre et la valeur de ce caractere en deuxieme 
parametre. Enfin, il existe une version template de cette methode permettant d'affecter a la ba- 
sic_string la sequence de caracteres compris entre deux iterateurs d'un conteneur. 

Exemple 14-4. Affectation de chaine de caracteres 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string si, s2; 

char *p="1234567890"; 

// Affecte "345" a si : 

si . assign (p+2, p+6) ; 

cout << si << endl; 

// Affecte les deux premiers caracteres de si a s2 : 

s2 . assign (si, 0, 2 ) ; 

cout << s2 << endl; 

// Reinitialise si avec des 'A' : 

si . assign (5, ' A' ) ; 

cout << si << endl; 

return 0; 



De maniere similaire, l'operateur d'affectation avec addition '+=' a ete surcharge afin de permettre 
les concatenations de chaines de caracteres de maniere intuitive. Cet operateur permet d'ajouter aussi 
bien une autre basic_string qu'une chaine de caracteres C classique ou un unique caractere a la fin 
d'une basic_string. Comme cet operateur est trop restrictif lorsqu'il s'agit de concatener une partie 
seulement d'une autre chaine a une basic_string, un jeu de methodes append a ete defini. Ces me- 
thodes permettent d'ajouter a une basic_string une autre basic_string ou une chaine de caracteres C 
bien entendu, mais aussi d'ajouter une partie seulement de ces chaines ou un nombre determine de 
caracteres. Toutes ces methodes prennent les memes parametres que les methodes assign correspon- 
dantes et leur emploi ne devrait pas poser de probleme particulier. 
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Exemple 14-5. Concatenation de chaines de carcteres 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string si = "abcef"; 

string s2 = "ghijkl"; 

// Utilisation de l'operateur de concatenation 

sl+=s2; 

cout << si << endl; 

// Utilisation de la methode append : 

si . append ( "mnopql23456" , 5 ) ; 

cout << si << endl; 

return 0; 
} 



14.1.5.2. Extraction de donnees d'une chaine de caracteres 

Nous avons vu que les methodes data et c_str permettaient d'obtenir des pointeurs sur les donnees 
des basic_string. Cependant, il est interdit de modifier les donnees de la basic_string au travers de ces 
pointeurs. Or, il peut etre utile, dans certaines situations, d' avoir a travailler sur ces donnees, il faut 
done pouvoir en faire une copie temporaire. C'est ce que permet la methode copy. Cette fonction 
prend en parametre un pointeur sur une zone de memoire devant accueillir la copie des donnees de la 
basic_string, le nombre de caracteres a copier, ainsi que le numero du caractere de la basic_string a 
partir duquel la copie doit commencer. Ce dernier parametre est facultatif, car il prend par defaut la 
valeur (la copie se fait done a partir du premier caractere de la basic_string. 

Exemple 14-6. Copie de travail des donnees d'une basic_string 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string s=" 1234567890 " ; 

// Copie la chaine de caracteres dans une zone de travail : 

char buffer [16]; 

s . copy (buff er, s.sizeO, 0); 

buf fer [s . size ( ) ] = 0; 

cout << buffer << endl; 

return 0; 
} 

La basic_string doit contenir suffisamment de caracteres pour que la copie puisse se faire. Si ce n'est 
pas le cas, elle lancera une exception out_of_range. En revanche, la methode copy ne peut faire 
aucune verification quant a la place disponible dans la zone memoire qui lui est passee en parametre. 
II est done de la responsabilite du programmeur de s' assurer que cette zone est suffisamment grande 
pour accueillir tous les caracteres qu'il demande. 
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La methode copy permet d'obtenir la copie d'une sous-chaine de la chaine contenue dans la ba- 
sic_string. Toutefois, si Ton veut stocker cette sous-chaine dans une autre basic_string, il ne faut pas 
utiliser cette methode. La methode substr permet en effet d'effectuer ce travail directement. Cette 
methode prend en premier parametre le numero du premier caractere a partir de la sous-chaine a co- 
pier, ainsi que sa longueur. Comme pour la methode copy, il faut que la basic_string source contienne 
suffisamment de caracteres faute de quoi une exception out_of_range sera lancee. 

Exemple 14-7. Extraction de sous-chaine 

#include <iostream> 
tinclude <string> 

using namespace std; 

int main (void) 
{ 

string si = "12345678 90"; 

string s2 = si. substr (2, 5); 

cout << s2 << endl; 

return 0; 
} 



14.1.5.3. Insertion et suppression de caracteres dans une chaine 

La classe basic_string dispose de tout un jeu de methodes d'insertion de caracteres ou de chaines de 
caracteres au sein d'une basic_string existante. Toutes ces methodes sont des surcharges de la methode 
insert. Ces surcharges prennent toutes un parametre en premiere position qui indique l'endroit ou 
F insertion doit etre faite. Ce parametre peut etre soit un numero de caractere, indique par une valeur 
de type size_type, soit un iterateur de la basic_string dans laquelle l'insertion doit etre faite. Les autres 
parametres permettent de specifier ce qui doit etre insere dans cette chaine. 

Les versions les plus simples de la methode insert prennent en deuxieme parametre une autre ba- 
sic_string ou une chaine de caracteres C classique. Leur contenu sera insere a l'emplacement indique. 
Lorsque le deuxieme parametre est une basic_string, il est possible d'indiquer le numero du premier 
caractere ainsi que le nombre de caracteres total a inserer. De meme, lors de l'insertion d'une chaine 
C classique, il est possible d'indiquer le nombre de caracteres de cette chaine qui doivent etre inseres. 

II existe aussi des methodes insert permettant d' inserer un ou plusieurs caracteres a un emplacement 
donne dans la chaine de caracteres. Ce caractere doit alors specifie en deuxieme parametre, sauf si 
Ton veut inserer plusieurs caracteres identiques dans la chaine, auquel cas on doit indiquer le nombre 
de caracteres a inserer et la valeur de ce caractere. 

Enfin, il existe une version de la methode insert qui prend en parametre, en plus de l'iterateur 
specifiant la position a partir de laquelle l'insertion doit etre faite dans la basic_string, deux autres ite- 
rateurs d'un quelconque conteneur contenant des caracteres. Utilise avec des pointeurs de caracteres, 
cet iterateur peut etre utilise pour inserer un morceau quelconque de chaine de caracteres C dans une 
basic_string. 

Toutes ces methodes renvoient generalement la basic_string sur laquelle ils travaillent, sauf les me- 
thodes qui prennent en parametre un iterateur. Ces methodes supposent en effet que la manipulation 
de la chaine de caracteres se fait par l'intermediaire de cet iterateur, et non par l'intermediaire d'une 
reference sur la basic_string. Cependant, la methode insert permettant d'inserer un caractere unique 
a un emplacement specifie par un iterateur renvoie la valeur de l'iterateur referencant le caractere qui 
vient d'etre insere afin de permettre de recuperer ce nouvel iterateur pour les operations ulterieures. 
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Exemple 14-8. Insertion de caracteres dans une chaine 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string s = "abef"; 

// Insere un ' c' et un ' d' : 

s. insert (2, "cdze", 2 ) ; 

// Idem pour ' g' et 'h', mais avec une basic_string : 

string gh = "gh"; 

s . insert ( 6, gh) ; 

cout << s << endl; 

return 0; 
} 

II existe egalement trois surcharges de la methode erase, dont le but est de supprimer des caracteres 
dans une chaine en decalant les caracteres suivant les caracteres supprimes pour remplir les positions 
ainsi liberees. La premiere methode erase prend en premier parametre la position du premier carac- 
tere et le nombre des caracteres a supprimer. La deuxieme methode fonctionne de maniere similaire, 
mais prend en parametre l'iterateur de debut et l'iterateur de fin de la sous-chaine de caracteres qui 
doit etre supprimee. Enfin, la troisieme version de erase permet de supprimer un unique caractere, 
dont la position est specifiee encore une fois par un iterateur. Ces deux dernieres methodes renvoient 
l'iterateur referencant le caractere suivant le dernier caractere qui a ete supprime de la chaine. S'il n'y 
avait pas de caracteres apres le dernier caractere efface, l'iterateur de fin de chaine est renvoye. 

Enfin, il existe une methode dediee pour l'effacement complet de la chaine de caracteres contenue 
dans une basic_string. Cette methode est la methode clear. 

Exemple 14-9. Suppression de caracteres dans une chaine 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string s = "abcdeerrf gh" ; 

// Supprime la faute de frappe : 

s . erase (5,3) ; 

cout << s << endl; 

// Efface la chaine de caracteres complete : 

s . clear ( ) ; 

if (s. empty ()) cout << "Vide !" << endl; 

return 0; 
} 
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14.1.5.4. Remplacements de caracteres d'une chatne 

Comme pour l'insertion de chaines de caracteres, il existe tout un jeu de fonctions permettant 
d'effectuer un remplacement d'une partie de la chaine de caracteres stockee dans les basic_string par 
une autre chaine de caracteres. Ces methodes sont nominees replace et sont tout a fait similaires 
dans le principe aux methodes insert. Cependant, contrairement a celles-ci, les methodes replace 
prennent un parametre supplemental pour specifier la longueur ou le caractere de fin de la 
sous-chaine a remplacer. Ce parametre doit etre fourni juste apres le premier parametre, qui indique 
toujours le caractere de debut de la sous-chaine a remplacer. II peut etre de type size_type pour 
les versions de replace qui travaillent avec des indices, ou etre un iterateur, pour les versions 
de replace qui travaillent avec des iterateurs. Les autres parametres des fonctions replace 
permettent de decrire la chaine de remplacement, et fonctionnent exactement comme les parametres 
correspondants des fonctions insert. 

Exemple 14-10. Remplacement d'une sous-chaine dans une chaine 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string s = "abcerfg"; 

// Remplace le 'e' et le ' r' par un ' d' et un 'e' : 

s.replace(3, 2, "de"); 

cout << s << endl; 

return 0; 
} 

Dans le meme ordre d'idee que le remplacement, on trouvera la methode swap de la classe ba- 
sic_string, qui permet d'intervertir le contenu de deux chaines de caracteres. Cette methode prend 
en parametre une reference sur la deuxieme chaine de caracteres, avec laquelle l'interversion doit 
etre faite. La methode swap pourra devra etre utilisee de preference pour realiser les echanges de 
chaines de caracteres, car elle est optimisee et effectue en fait l'echange par reference. Elle permet 
done d'eviter de faire une copie temporaire de la chaine destination et d'ecraser la chaine source avec 
cette copie. 

Exemple 14-11. Echange du contenu de deux chaines de caracteres 

tinclude <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string si = "abed"; 

string s2 = "1234"; 

cout << "si = " << si << endl; 

cout << "s2 = " << s2 << endl; 

// Intervertit les deux chaines : 

si . swap (s2) ; 

cout << "si = " << si << endl; 

cout << "s2 = " << s2 << endl; 
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return ; 
} 



14.1.6. Comparaison de chames de caracteres 

La comparaison des basic_string se base sur la methode compare, dont plusieurs surcharges existent 
afin de permettre des comparaisons diverses et variees. Les deux versions les plus simples de la 
methode compare prennent en parametre soit une autre basic_string, soit une chaine de caracteres C 
classique. Elles effectuent done la comparaison de la basic_string sur laquelle elles s'appliquent avec 
ces chaines. Elles utilisent pour cela la methode eq de la classe des traits des caracteres utilises par 
la chaine. Si les deux chaines ne different que par leur taille, la chaine la plus courte sera declaree 
inferieure a la chaine la plus longue. 

Les deux autres methodes compare permettent d'effectuer la comparaison de sous-chaines de carac- 
teres entre elles. Elles prennent toutes les deux l'indice du caractere de debut et l'indice du caractere 
de fin de la sous-chaine de la basic_string sur laquelle elles sont appliquees, un troisieme parametre 
indiquant une autre chaine de caracteres, et des indices specifiant la deuxieme sous-chaine dans cette 
chaine. Si le troisieme argument est une basic_string, il faut specifier egalement l'indice de debut et 
l'indice de fin de la sous-chaine. En revanche, s'il s'agit d'une chaine C classique, la deuxieme sous- 
chaine commence toujours au premier caractere de cette chaine, et il ne faut specifier que la longueur 
de cette sous-chaine. 

La valeur renvoyee par les methodes compare est de type entier. Cet entier est nul si les deux chaines 
sont strictement egales (et de meme taille), negatif si la basic_string sur laquelle la methode compare 
est appliquee est plus petite que la chaine passee en argument, soit en taille, soit au sens de 1'ordre 
lexicographique, et positif dans le cas contraire. 

Exemple 14-12. Comparaisons de chaines de caracteres 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

const char *cl = "bederefb"; 

const char *c2 = "bedetab"; // c2 > cl 

const char *c3 = "bederefas"; // c3 < cl 

const char *c4 = "bede"; // c4 < cl 

string si = cl; 

if (si < c2) cout << "cl < c2" << endl; 

else cout << "cl >= c2" << endl; 

if (si .compare (c3) >0) cout << "cl > c3" << endl; 

else cout << "cl <= c3" << endl; 

if (si . compare ( 0, string: : npos, cl, 4)>0) 
cout << "cl > c4" << endl; 

else cout << "cl <= c4" << endl; 

return 0; 
} 

Bien entendu, les operateurs de comparaison classiques sont egalement definis afin de permettre des 
comparaisons simples entre chaine de caracteres. Grace a ces operateurs, il est possible de manipuler 
les basic_string exactement comme les autres types ordonnes du langage. Plusieurs surcharge de 
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ces operateurs ont ete definies et travaillent avec les differents types de donnees avec lesquels il est 
possible pour une basic_string de se comparer. L'emploi de ces operateurs est naturel et ne pose pas 
de problemes particuliers. 

Note : Toutes ces comparaisons se basent sur I'ordre lexicographique du langage C. Autrement 
dit, les comparaisons entre chaines de caracteres ne tiennent pas compte de la locale et des 
conventions nationales. Elles sont done tres efficaces, mais ne pourront pas etre utilisees pour 
comparer des chaines de caracteres humainement lisibles. Vous trouverez de plus amples ren- 
seignements sur la maniere de prendre en compte les locales dans les comparaisons de chaines 
de caracteres dans le Chapitre 16. 



14.1.7. Recherche dans les chaines 

Les operations de recherche dans les chaines de caracteres constituent une des fonctionnalites des 
chaines les plus courantes. Elles constituent la plupart des operations d' analyse des chaines, et sont 
souvent le pendant de la construction et la concatenation de chaines. La classe basic_string fournit 
done tout un ensemble de methodes permettant d'effectuer des recherches de caracteres ou de sous- 
chaines dans une basic_string. 

Les fonctions de recherche sont toutes surchargees afin de permettre de specifier la position a partir 
de laquelle la recherche doit commencer d'une part, et le motif de caractere a rechercher. Le premier 
parametre indique toujours quel est ce motif, que ce soit une autre basic_string, une chaine de ca- 
racteres C classique ou un simple caractere. Le deuxieme parametre est le numero du caractere de 
la basic_string sur laquelle la methode de recherche s' applique et a partir duquelle elle commence. 
Ce deuxieme parametre peut etre utilise pour effectuer plusieurs recherches successives, en repartant 
de la derniere position trouvee a chaque fois. Lors d'une premiere recherche ou lors d'une recherche 
unique, il n'est pas necessaire de donner la valeur de ce parametre, car les methodes de recherche uti- 
lisent la valeur par defaut qui convient (soit le debut de la chaine, soit la fin, selon le sens de recherche 
utilise par la methode). Les parametres suivants permettent de donner des informations complemen- 
taires sur le motif a utiliser pour la recherche. II n'est utilise que lorsque le motif est une chaine de 
caracteres C classique. Dans ce cas, il est en effet possible de specifier la longueur du motif dans cette 
chaine. 

Les differentes fonctions de recherche disponibles sont presentees dans le tableau suivant : 
Tableau 14-1. Fonctions de recherche dans les chaines de caracteres 



Methode 


Description 


find 


Cette methode permet de rechercher la sous-chaine correspondant au 
motif passe en parametre dans la basic_string sur laquelle elle est 
appliquee. Elle retourne l'indice de la premiere occurrence de ce motif 
dans la chaine de caracteres, ou la valeur npos si le motif n'y apparait pas. 


rf ind 


Cette methode permet d'effectuer une recherche similaire a celle de la 
methode find, mais en parcourant la chaine de caracteres en sens inverse. 
Notez bien que ce n'est pas le motif qui est inverse ici, mais le sens de 
parcours de la chaine. Ainsi, la methode rf ind retourne l'indice de la 
derniere occurrence du motif dans la chaine, ou la valeur npos si le motif 
n'apas ete trouve. 
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Methode 


Description 


f ind_f irst_of 


Cette methode permet de rechercher la premiere occurrence d'un des 
caracteres presents dans le motif fourni en parametre. 11 ne s'agit done plus 
d'une recherche de chaine de caracteres, mais de la recherche de tous les 
caracteres d'un ensemble donne. La valeur retournee est l'indice du 
caractere trouve, ou la valeur npos si aucun caractere du motif n'est 
detecte dans la chaine. 


f ind_last_of 


Cette methode est a la methode f ind_f irst_of ce que rf ind est a 
find. Elle effectue la recherche du dernier caractere de la basic_string qui 
se trouve dans la liste des caracteres du motif fourni en parametre. La 
valeur retournee est l'indice de ce caractere s'il existe, et npos sinon. 


f ind_f irst_not_of 


Cette methode travaille en logique inverse par rapport a la methode 
f ind_f irst_of . En effet, elle recherche le premier caractere de la 
basic_string qui n'est pas dans le motif fourni en parametre. Elle renvoie 
l'indice de ce caractere, ou npos si celui-ci n'existe pas. 


f ind_last_not_of 


Cette methode effectue le meme travail que la methode 
f ind_f irst_not_of , mais en parcourant la chaine de caracteres source 
en sens inverse. Elle determine done l'indice du premier caractere en 
partant de la fin qui ne se trouve pas dans le motif fourni en parametre. 
Elle renvoie npos si aucun caractere ne correspond a ce critere. 



Exemple 14-13. Recherches dans les chaines de caracteres 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string s = "Bonjour tout le monde !"; 

// Recherche le mot "monde" : 

string :: size_type pos = s . find ( "monde" ) ; 

cout << pos << endl; 

// Recherche le mot "tout" en commencant par la fin : 

pos = s . rf ind ("tout" ) ; 

cout << pos << endl; 

// Decompose la chaine en mots : 

string :: size_type debut = s . f ind_f irst_not_of ( " \t\n") 

while (debut != string: : npos) 

{ 

// Recherche la fin du mot suivant : 

pos = s . f ind_f irst_of ( " \t\n", debut); 

// Affiche le mot : 

if (pos != string: :npos) 

cout << s . substr (debut, pos - debut) << endl; 

else 

cout << s . substr (debut ) << endl; 

debut = s . f ind_f irst_not_of ( " \t\n", pos); 
} 
return 0; 
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Note : Toutes ces fonctions de recherche utilisent I'ordre lexicographique du langage C pour 
effectuer leur travail. Elles peuvent done ne pas convenir pour effectuer des recherches dans des 
chaines de caracteres saisies par des humains, car elles ne prennent pas en compte la locale et 
les parametres nationaux de I'utilisateur. La raison de ce choix est essentiellement la recherche 
de I'efficacite dans la bibliotheque standard. Nous verrons dans le Chapitre 16 la maniere de 
proceder pour prendre en compte les parametres nationaux au niveau des chaines de caracteres. 



14.1.8. Fonctions d'entree / sortie des chaines de caracteres 

Pour terminer ce tour d' horizon des chaines de caracteres, signalons que la bibliotheque standard C++ 
fournit des operateurs permettant d' effectuer des ecritures et des lectures sur les flux d' entree / sortie. 
Les operateurs '<<' et '>>' sont done surcharges pour les basic_string, et permettent de manipuler 
celles-ci comme des types normaux. L'operateur '<<' permet d'envoyer le contenu de la basic_string 
sur le flux de sortie standard. L'operateur ' >>' lit les donnees du flux d'entree standard, et les affecte 
a la basic_string qu'il recoit en parametre. II s'arrete des qu'il rencontre le caractere de fin de fichier, 
un espace, ou que la taille maximale des basic_string a ete atteinte (cas improbable) : 

#include <iostream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

string si, s2; 

cin >> si; 

cin >> s2; 

cout << "Premier mot : " << endl << si << endl; 

cout << "Deuxieme mot : " << endl << s2 << endl; 

return 0; 



Cependant, ces operateurs peuvent ne pas s'averer suffisants. En effet, l'une des principales difficultes 
dans les programmes qui manipulent des chaines de caracteres est de lire les donnees qui proviennent 
d'un flux d'entree ligne par ligne. La notion de ligne n'est pas tres claire, et depend fortement de 
l'environnement d' execution. La bibliotheque standard C++ suppose, quant a elle, que les lignes sont 
delimitees par un caractere special servant de marqueur special. Generalement, ce caractere est le 
caractere ' \n' , mais il est egalement possible d'utiliser d'autres separateurs. 

Pour simplifier les operations de lecture de textes constitues de lignes, la bibliotheque fournit la fonc- 
tion getline. Cette fonction prend en premier parametre le flux d'entree sur lequel elle doit lire la 
ligne, et la basic_string dans laquelle elle doit stocker cette ligne en deuxieme parametre. Le troisieme 
parametre permet d'indiquer le caractere separateur de ligne. Ce parametre est facultatif, car il dispose 
d'une valeur par defaut qui correspond au caractere de fin de ligne classique ' \n' . 

Exemple 14-14. Lecture de lignes sur le flux d'entree 

#include <iostream> 
#include <string> 

using namespace std; 
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int main (void) 
{ 

string si, s2; 

getline(cin, si); 

getline(cin, s2); 

cout << "Premiere ligne : " << si << endl; 

cout << "Deuxieme ligne : " << s2 << endl; 

return 0; 
} 



14.2. Les types utilitaires 

La bibliotheque standard utilise en interne un certain nombre de types de donnees specifiques, es- 
sentiellement dans un but de simplicite et de facilite d'ecriture. Ces types seront en general rarement 
utilises par les programmeurs, mais certaines fonctionnalites de la bibliotheque standard peuvent y 
avoir recours. II faut done connaitre leur existence et savoir les manipuler correctement. 

14.2.1. Les pointeurs auto 

La plupart des variables detruisent leur contenu lorsqu'elles sont detruites elles-memes. Une exception 
notable a ce comportement est bien entendu celle des pointeurs, qui par definition ne contiennent pas 
eux-memes leurs donnees mais plutot une reference sur celles-ci. Lorsque ces donnees sont allouees 
dynamiquement, il faut systematiquement penser a les detruire manuellement lorsqu'on n'en a plus 
besoin. Cela peut conduire a des fuites de memoire (« Memory Leak » en anglais) tres facilement. 
Si de telles fuites ne sont pas genantes pour les processus dont la duree de vie est tres courte, elles 
peuvent l'etre considerablement plus pour les processus destines a fonctionner longtemps, si ce n'est 
en permanence, sur une machine. 

En fait, dans un certain nombre de cas, 1' allocation dynamique de memoire n'est utilisee que pour 
effectuer localement des operations sur un nombre arbitraire de donnees qui ne peut etre connu qu'a 
1' execution. Cependant, il est relativement rare d' avoir a conserver ces donnees sur de longues pe- 
riodes, et il est souvent souhaitable que ces donnees soient detruites lorsque la fonction qui les a 
allouees se termine. Autrement dit, il faudrait que les pointeurs detruisent automatiquement les don- 
nees qu'ils referencent lorsqu'ils sont eux-memes detruits. 

La bibliotheque standard C++ fournit a cet effet une classe d' encapsulation des pointeurs, qui permet 
d'obtenir ces fonctionnalites. Cette classe se nomme auto_ptr, en raison du fait que ses instances 
sont utilisees comme des pointeurs de donnees dont la portee est la meme que celle des variables 
automatiques. La declaration de cette classe est realisee comme suit dans l'en-tete memory : 

template <class T> 
class auto_ptr 
{ 
public : 

typedef T element_type; 

explicit auto_ptr (T *pointeur = 0) throw (); 

auto_ptr (const auto_ptr Ssource) throw () ; 

template <class U> 

auto_ptr (const auto_ptr<U> Ssource) throw () ; 

~auto_ptr() throw (); 

auto_ptr &operator= (const auto_ptr Ssource) throw)) ; 
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template <class U> 

auto_ptr &operator= (const auto_ptr<U> Ssource) throw () 

T &operator*() const throw (); 

T *operator-> ( ) const throw (); 

T *get() const throw (); 

T *release() const throw (); 

}; 



Cette classe permet de construire un objet controlant un pointeur sur un autre objet alloue dynami- 
quement avec l'operateur new. Lorsqu'il est detruit, l'objet reference est automatiquement detruit par 
un appel a l'operateur delete. Cette classe utilise done une semantique de propriete stricte de l'objet 
contenu, puisque le pointeur ainsi controle ne doit etre detruit qu'une seule fois. 

Cela implique plusieurs remarques. Premierement, il y a necessairement un transfert de propriete 
du pointeur encapsule lors des operations de copie et d' affectation. Deuxiemement, toute operation 
susceptible de provoquer la perte du pointeur encapsule provoque sa destruction automatiquement. 
C'est notamment le cas lorsqu'une affectation d'une autre valeur est faite sur un auto_ptr contenant 
deja un pointeur valide. Enfin, il ne faut jamais detruire soi-meme l'objet pointe une fois que Ton a 
affecte un pointeur sur celui-ci a un auto_ptr. 

II est tres simple d'utiliser les pointeurs automatiques. En effet, il suffit de les initialiser a leur 
construction avec la valeur du pointeur sur l'objet alloue dynamiquement. Des lors, il est possible 
d'utiliser l'auto_ptr comme le pointeur original, puisqu'il definit les operateurs '*' et '->'. 

Les auto_ptr sont souvent utilises en tant que variable automatique dans les sections de code suscep- 
tible de lancer des exceptions, puisque la remontee des exceptions detruit les variables automatiques. 
II n'est done plus necessaire de traiter ces exceptions et de detruire manuellement les objets alloues 
dynamiquement avant de relancer 1' exception. 

Exemple 14-15. Utilisation des pointeurs automatiques 

#include <iostream> 
#include <memory> 

using namespace std; 

class A 
{ 
public : 

A() 

{ 

cout << "Constructeur" << endl; 

} 

~A() 

{ 

cout << "Destructeur" << endl; 

} 

}; 

// Fonction susceptible de lancer une exception : 
void f() 

// Alloue dynamiquement un objet : 

auto_ptr<A> p (new A) ; 
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II Lance une exception, en laissant au pointeur 
// automatique le soin de detruire l'objet alloue 
throw 2; 
} 

int main (void) 
{ 

try 

{ 

f 0; 

} 

catch (...) 

{ 

} 

return ; 



Note : On prendra bien garde au fait que la copie d'un auto_ptr dans un autre effectue un trans- 
fert de propriete. Cela peut provoquer des surprises, notamment si Ton utilise des parametres 
de fonctions de type auto_ptr (chose expressement deconseillee). En effet, il y aura systema- 
tiquement transfert de propriete de l'objet lors de I'appel de la fonction, et c'est done la fonction 
appelee qui en aura la responsabilite. Si elle ne fait aucun traitement special, l'objet sera detruit 
avec le parametre de la fonction, lorsque I'execution du programme en sortira I Inutile de dire que 
la fonction appelante risque d'avoir des petits problemes... Pour eviter ce genre de problemes, il 
est plutot conseille de passer les auto_ptr par reference constante plutot que par valeur dans les 
appels de fonctions. 

Un autre piege classique est d'initialiser un auto_ptr avec I'adresse d'un objet qui n'a pas ete 
alloue dynamiquement. II est facile de faire cette confusion, car on ne peut a priori pas dire si un 
pointeur pointe sur un objet alloue dynamiquement ou non. Quoi qu'il en soit, si vous faites cette 
erreur, un appel a delete sera fait avec un parametre incorrect lors de la destruction du pointeur 
automatique et le programme plantera. 

Enfin, sachez que les pointeurs automatiques n'utilisent que I'operateur delete pour detruire 
les objets qu'ils encapsulent, jamais I'operateur delete u. Par consequent, les pointeurs au- 
tomatiques ne devront jamais etre initialises avec des pointeurs obtenus lors d'une allocation 
dynamique avec I'operateur new [ ] ou avec la fonction maiioc de la bibliotheque C. 



II est possible de recuperer la valeur du pointeur pris en charge par un pointeur automatique simple- 
ment, grace a la methode get. Cela permet de travailler avec le pointeur original, cependant, il ne faut 
jamais oublier que c'est le pointeur automatique qui en a toujours la propriete. II ne faut done jamais 
appeler delete sur le pointeur obtenu. 

En revanche, si Ton veut sortir le pointeur d'un auto_ptr, et forcer celui-ci a en abandonner la pro- 
priete, on peut utiliser la methode release. Cette methode renvoie elle-aussi le pointeur sur l'objet 
que l'auto_ptr contenait, mais libere egalement la reference sur l'objet pointe au sein de l'auto_ptr. 
Ainsi, la destruction du pointeur automatique ne provoquera plus la destruction de l'objet pointe et il 
faudra a nouveau prendre en charge cette destruction soi-meme. 

Exemple 14-16. Sortie d'un pointeur d'un auto_ptr 

#include <iostream> 
#include <memory> 

using namespace std; 
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class A 
{ 
public : 

A() 

{ 

cout << "Constructeur " << endl; 

} 

~A() 

{ 

cout << "Destructeur" << endl; 

} 

}; 

A *f (void) 
{ 

cout << "Construcion de l'objet" << endl; 

auto_ptr<A> p (new A) ; 

cout << "Extraction du pointeur" << endl; 

return p. release (); 
} 

int main (void) 
{ 

A *pA = f () ; 

cout << "Destruction de l'objet" << endl; 

delete pA; 

return 0; 
} 



14.2.2. Les paires 

Outre les pointeurs automatiques, la bibliotheque standard C++ definit une autre classe utilitaire qui 
permet quant a elle de stocker un couple de valeurs dans un meme objet. Cette classe, la classe 
template pair, est en particulier tres utilisee dans 1' implementation de certains conteneurs de la 
bibliotheque. 

La declaration de la classe template pair est la suivante dans l'en-tete utility : 

template <class Tl, class T2> 

struct pair 

{ 

typedef Tl first_type; 

typedef T2 second_type; 

Tl first; 
T2 second; 

pair () ; 

pair (const Tl S, const T2 &); 
template <class Ul, class U2> 
pair(const pair<Ul, U2> &); 



template <class Tl, class T2> 

bool operator== (const pair<Tl, T2> &, const pair<Tl, T2> &); 
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template <class Tl, class T2> 

bool operator< (const pair<Tl, T2> &, const pair<Tl, T2> &); 

template <class Tl, class T2> 

pair<Tl, T2> make_pair (const Tl &, const T2 &); 



Comme cette declaration le montre, 1' utilisation de la classe pair est extremement simple. La construc- 
tion d'une paire se fait soit en fournissant le couple de valeurs devant etre stocke dans la paire, soit en 
appelant la fonction make_pair. La recuperation des deux composantes d'une paire se fait simple- 
ment en accedant aux donnees membres publiques first et second. 

Exemple 14-17. Utilisation des paires 

#include <iostream> 
#include <utility> 

using namespace std; 

int main (void) 
{ 

// Construit une paire associant un entier 

// a un flottant : 

pair<int, double> pi (5, 7.38), p2; 

// Initialise p2 avec make_pair : 

p2 = make_pair(9, 3.14); 

// Affiche les deux paires : 

cout << "pi = (" << pi. first << ", " 
<< pi. second << ")" << endl; 

cout << "p2 = (" << p2. first << ", " 
<< p2 . second << ")" << endl; 

return 0; 
} 

La classe template pair dispose egalement d'operateurs de comparaison qui utilisent l'ordre lexico- 
graphique induit par les valeurs de ses deux elements. Deux paires sont done egales si et seulement 
si leurs couples de valeurs sont egaux membre a membre, et une paire est inferieure a 1' autre si la 
premiere valeur de la premiere paire est inferieure a la valeur correspondante de la deuxieme paire, 
ou, si elles sont egales, la deuxieme valeur de la premiere paire est inferieure a la deuxieme valeur de 
la deuxieme paire. 



14.3. Les types numeriques 



En plus des types d'interet general vus dans les sections precedentes, la bibliotheque standard fournit 
des types de donnees plus specialises dans les calculs numeriques ou mathematiques. Ces types de 
donnees permettent d'effectuer des calculs sur les nombres complexes, ainsi que des calculs paralleles 
sur des tableaux de valeurs. 



256 



Chapitre 14. Les types complementaires 

14.3.1. Les complexes 

Les types de base du langage C++ fournissent une approximation relativement fiable des differents 
domaines de nombres mathematiques. Par exemple, le type int permet de representer une plage de 
valeurs limitee des entiers relatifs, mais suffisamment large toutefois pour permettre d'effectuer la 
plupart des calculs intervenant dans la vie reelle. De meme, les types des nombres a virgule flot- 
tante fournissent une approximation relativement satisfaisante des nombres reels des mathematiques. 
L' approximation cette fois porte non seulement sur la plage de valeur accessible, mais egalement sur 
la precision des nombres. 

Note : On prendra bien conscience du fait que les types du langage ne represented effective- 
ment que des approximations, car les ordinateurs sont des machines limitees en memoire et en 
capacite de representation du monde reel. II faut done toujours penser aux eventuels cas de 
debordements et erreurs de representation des nombres, surtout en ce qui concerne les nom- 
bres reels. Les bogues les plus graves (en terme de pertes materielles ou humaines) sont souvent 
dus a de tels debordements, qui sont inherents aux techniques utilisees par I'informatique (meme 
avec des langages plus « surs » que le C++). 



II existe en mathematiques un autre type de nombres, qui n'ont pas de representation physique im- 
mediate pour le commun des mortels, mais qui permettent souvent de simplifier beaucoup certains 
calculs : les nombres complexes. Ces nombres etendent en effet le domaine des nombres accessibles 
et permettent de poursuivre les calculs qui n'etaient pas realisables avec les nombres reels seulement, 
en s'affranchissant des contraintes imposees sur les solutions des equations algebriques. Les nombres 
complexes sont done d'une tres grande utilite dans toute l'algebre, et en particulier dans les calculs 
matriciels ou ils prennent une place predominante. Les nombres complexes permettent egalement de 
simplifier serieusement les calculs trigonometriques, les calculs de signaux en electricite et les cal- 
culs en mecanique quantique. Le plus interessant avec ces nombres est sans doute le fait que meme 
si les resultats intermediaires que Ton trouve avec eux n'ont pas de signification reelle, les resultats 
finaux, eux, peuvent en avoir une et n'auraient pas ete trouves aussi facilement en conservant toutes 
les contraintes imposees par les nombres reels. 

Afin de simplifier la vie des programmeurs qui ont besoin de manipuler des nombres complexes, 
la bibliotheque standard C++ definit la classe template complex, qui permet de les representer et 
d'effectuer les principales operations mathematiques dessus. Si l'utilisation de la classe complex en 
soi ne pose aucun probleme particulier, il peut etre utile de donner une description sommaire de 
ce qu'est un nombre complexe pour les neophytes en mathematiques. Toutefois, cette description 
n'est pas destinee aux personnes n' ay ant aucune connaissance en mathematiques (si tant est qu'un 
programmeur puisse etre dans ce cas...). Si vous ne la comprenez pas, e'est sans doute que vous 
n'avez aucunement besoin des nombres complexes et vous pouvez done passer cette section sans 
crainte. 

14.3.1.1. Definition et principales proprietes des nombres complexes 

II n'est pas complique de se representer ce que signifie un nombre reel puisqu'on les utilise couram- 
ment dans la vie courante. La methode la plus simple est d'imaginer une regie graduee ou chaque 
position est donnee par un nombre reel par rapport a l'origine. Ce nombre indique le nombre de fois 
que l'unite de distance doit etre repetee depuis l'origine pour arriver a cette position. 

Pour se representer la valeur d'un nombre complexe, il faut utiliser une dimension supplemental. 
En fait, tout nombre complexe peut etre exprime avec deux valeurs reelles : la partie reelle du com- 
plexe, et sa partie imaginaire. Plusieurs notations existent pour representer les nombres complexes a 
partir de ces deux parties. La plus courante est de donner la partie reelle et la partie imaginaire entre 
parentheses, separees par une virgule : 
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(reelle, imaginaire) 

ou reelle est la valeur de la partie reelle, et imaginaire la valeur de la partie imaginaire. II est 
egalement tres courant en France de noter les deux parties directement en les separant d'un signe 
d' addition et en accolant le caractere 'i' (pour « imaginaire ») a la partie imaginaire : 

reelle + imaginaire i 

L'exemple suivant vous presente quelques nombres complexes : 

7.56 
3i 

5 + 7i 

Vous constaterez que les nombres reels peuvent parfaitement etre representes par les nombres com- 
plexes, puisqu'il suffit simplement d'utiliser une partie imaginaire nulle. 

Les operations algebriques classiques ont ete definies sur les nombres complexes. Les additions et 
soustractions se font membre a membre, partie reelle avec partie reelle et partie imaginaire avec partie 
imaginaire. En revanche, la multiplication est un peu plus complexe, car elle se base sur la propriete 
fondamentale que le carre de 1' unite de la partie imaginaire vaut -1. Autrement dit, le symbole i de 
la notation precedente dispose de la propriete fondamentale suivante : i 2 =-l. II s'agit en quelque 
sorte d'une racine carree de -1 (la racine carree des nombres negatifs n' ay ant pas de sens, puisqu'un 
carre est normalement toujours positif, on comprend la qualification d'« imaginaire » des nombres 
complexes). A partir de cette regie de base, et en conservant les regies d'associativite des operateurs, 
on peut definir le produit de deux nombres complexes comme suit : 

(a,b) * (c,d) = (ac - bd, ad + be) 

Enfin, la division se definit toujours comme T operation inverse de la multiplication, e'est-a-dire 
F operation qui trouve le nombre qui, multiplie par le diviseur, redonne le dividende. Chaque nombre 
complexe non nul dispose d'un inverse, qui est le resultat de la division de 1 par ce nombre. On peut 
montrer facilement que 1' inverse d'un nombre complexe est defini comme suit : 

l/(a,b) = (a / (a 2 + b 2 ), -b / (a 2 + b 2 )) 

A partir de l'inverse, il est simple de calculer une division quelconque. 

Comme il l'a ete dit plus haut, les nombres complexes peuvent etre representes en utilisant une dimen- 
sion supplementaire. Ainsi, si on definit un repere dans le plan, dont l'axe des abscisses est associe a 
la partie reelle des nombres complexes et l'axe des ordonnees a la partie imaginaire, a tout nombre 
complexe est associe un point du plan. On appelle alors ce plan le plan complexe. La definition des 
complexes donnee ici correspond done a un systeme de coordonnees cartesiennes du plan complexe, 
et chaque nombre complexe dispose de ses propres coordonnees. 

En mathematiques, il est egalement courant d'utiliser un autre systeme de coordonnees : le systeme 
de coordonnees polaires. Dans ce systeme, chaque point du plan est identifie non plus par les coor- 
donnees de ses projections orthogonales sur les axes du repere, mais par sa distance a l'origine et par 
Tangle que la droite qui rejoint l'origine au point fait avec l'axe des abscisses. Ces deux nombres sont 
couramment notes respectivement avec les lettres grecques rho et theta. La denomination de coordon- 
nees polaires provient du fait que l'origine du repere joue le role d'un pole par rapport auquel on situe 
le point dans le plan. 

II est done evident que les nombres complexes peuvent egalement etre representes par leurs coor- 
donnees polaires. On appelle generalement la distance a l'origine la norme du nombre complexe, et 
Tangle qu'il fait avec l'axe des abscisses son argument. Faites bien attention a ce terme, il ne repre- 
sente pas un argument d'une fonction ou quoi que ce soit qui se rapporte a la programmation. 
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La plupart des fonctions mathematiques classiques ont ete definies sur les nombres complexes, par- 
fois en restreignant leur domaine de validite. Ainsi, il est possible de calculer un sinus, un cosinus, 
une exponentielle, etc. pour les nombres complexes. II est bien entendu hors de question de definir 
rigoureusement, ni meme de presenter succinctement ces fonctions dans ce document. Cependant, il 
est bon de savoir qu'on ne peut pas definir une relation d'ordre sur les nombres complexes. Autrement 
dit, on ne peut pas faire d'autre comparaison que l'egalite entre deux nombres complexes (essayez de 
comparer les nombres complexes situes sur un cercle centre a l'origine dans le plan complexe pour 
vous en rendre compte). 



14.3.1.2. La classe complex 

La classe template complex est definie dans l'en-tete complex de la bibliotheque standard. Cette 
classe peut etre instanciee pour l'un quelconque des trois types de nombre a virgule flottante du 
langage : float, double ou long double. Elle permet d'effectuer les principales operations definies sur 
les nombres complexes, comme les additions, soustractions, multiplications, division, mais egalement 
des operations specifiques aux nombres complexes, comme la determination de leur argument ou de 
leur norme. Enfin, l'en-tete complex contient des surcharges des fonctions mathematiques standards, 
telles que les fonctions trigonometriques, la racine carree, les puissances et exponentielles, ainsi que 
les logarithmes (definis sur le plan complexe auquel l'axe des abscisses negatives a ete ote). 

La construction d'un complexe ne pose aucun probleme en soi. La classe complex dispose d'un 
constructeur par defaut, d'un constructeur de copie et d'un constructeur prenant en parametre la partie 
reelle et la partie imaginaire du nombre : 

#include <iostream> 
#include <complex> 

using namespace std; 

int main (void) 
{ 

complex<double> c(2,3); 

cout << c << endl; 

return 0; 
} 



L'exemple precedent presente egalement 1'operateur de sortie sur les flux standards, qui formate un 
nombre complexe en utilisant la notation (reel, imaginaire) . II existe egalement une surcharge 
de 1'operateur d' entree pour le flux d'entree : 

#include <iostream> 
tinclude <complex> 

using namespace std; 

int main (void) 
{ 

complex<double> c; 

cin >> c; 

cout << "Vous avez saisi : " << c << endl; 

return 0; 
} 
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Note : Malheureusement, cette notation pose des problemes avec la locale frangaise, puisque 
nous utilisons des virgules pour separer la partie entiere de la partie decimale des nombres a 
virgules. Lorsque I'un des deux nombres flottants est un entier, il est impossible de determiner 
ou se trouve la virgule separant la partie entiere de la partie imaginaire du nombre complexe. 
Une premiere solution est de modifier le formatage des nombres reels pour que les chiffres apres 
la virgule soient toujours affiches, meme s'ils sont nuls. Cependant, il faut egalement imposer 
que les saisies des nombres soient egalement toujours effectues avec des nombres a virgules, 
ce qui est sujet a erreur et inverifiable. II est done recommande de n'utiliser que la locale de la 
bibliotheque C lorsqu'on fait un programme utilisant les nombres complexes. 



II n'existe pas de constructeur permettant de creer un nombre complexe a partir de ses coordonnees 
polaires. En revanche, la fonction polar permet d'en construire un. Cette fonction prend en para- 
metre la norme du complexe a construire ainsi que son argument. Elle renvoie le nombre complexe 
nouvellement construit. 

La partie imaginaire et la partie reelle d'un nombre complexe peuvent etre recuperees a tout instant a 
l'aidedes methodes real et imagdelaclasse template complex. II est egalement possible d'utiliser 
les fonctions template real et imag, qui prennent toutes deux le nombre complexe dont il faut cal- 
culer la partie reelle et la partie imaginaire. De meme, la norme d'un nombre complexe est retournee 
par la fonction abs, et son argument peut etre obtenu avec la fonction arg. 

Bien entendu, les operations classiques sur les complexes se font directement, comme s'il s'agissait 
d'un type predefini du langage : 

#include <iostream> 
#include <complex> 

using namespace std; 

int main (void) 
{ 

complex<double> cl(2.23, 3.56); 

complex<double> c2 (5, 5); 

complex<double> c = cl+c2; 

c = c/ (cl-c2) ; 

cout << c << endl; 

return ; 



Les fonctions specifiques permettant de manipuler les complexes et de leur appliquer les operations 
qui leurs sont propres sont recapitulees dans le tableau suivant : 



Tableau 14-2. Fonctions specifiques aux complexes 



Fonction 


Description 


real 


Retourne la partie reelle du nombre complexe. 


imag 


Retourne la partie imaginaire du nombre complexe. 


abs 


Retourne la norme du nombre nombre complexe, e'est-a-dire sa distance a 
Porigine. 
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Fonction 


Description 


arg 


Retourne 1' argument du nombre complexe. 


norm 


Retourne le carre de la norme du nombre complexe. Attention, cette 
fonction porte mal son nom, puisque la vraie norme est retournee par la 
surcharge de la fonction abs pour les nombres complexes. Cette 
incoherence provient de 1' interpretation differente de celle des Francais 
que font les Anglo-saxons de la notion de norme. 


con j 


Retourne le nombre complexe conjugue du nombre complexe fourni en 
argument. Le nombre conjugue d'un nombre complexe est son symetrique 
par rapport a l'axe des abscisses dans le plan complexe, c'est-a-dire qu'il 
dispose de la meme partie reelle, mais que sa partie imaginaire est opposee 
a celle du nombre complexe original (cela revient egalement a dire que 
1' argument du conjugue est l'oppose de 1'argument du complexe original). 
Le produit d'un nombre complexe et de son conjugue donne le carre de sa 
norme. 


polar 


Permet de construire un nombre complexe a partir de ses coordonnees 
polaires. 



Exemple 14-18. Manipulation des nombres complexes 

#include <iostream> 
#include <complex> 

using namespace std; 

int main (void) 
{ 

// Cree un nombre complexe : 

complex<double> c(2,3); 

// Determine son argument et sa norme : 

double Arg = arg(c); 

double Norm = abs (c) ; 

// Construit le nombre complexe conjugue : 

complex<double> co = polar (Norm, -Arg) ; 

// Affiche le carre de la norme du conjugue : 

cout << norm(co) << endl; 

// Calcule le carre ce cette norme par le produit 

// du complexe et de son conjugue : 

cout << real(c * conj (c) ) << endl; 

return 0; 



14.3.2. Les tableaux de valeurs 

Comme il l'a ete explique dans le Chapitre 1, les programmes classiques fonctionnent toujours sur le 
meme principe : ils travaillent sur des donnees qu'ils recoivent en entree et produisent des resultats en 
sortie. Ce mode de fonctionnement convient dans la grande majorite des cas, et en fait les programmes 
que Ton appelle couramment les « filtres » en sont une des applications principales. Unfiltre n'est 
rien d'autre qu'un programme permettant, comme son nom l'indique, de filtrer les donnees recues en 
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entree selon un critere particulier et de ne fournir en sortie que les donnees qui satisfont ce critere. 
Certains filtres plus evolues peuvent meme modifier les donnees a la volee ou les traduire dans un 
autre format. Les filtres sont tres souvent utilises avec les mecanismes de redirection des systemes 
qui les supportent afin d'executer des traitements complexes sur les flux de donnees a partir de filtres 
simples, en injectant les resultats des uns dans le flux d'entree des autres. 

Cependant, ce modele a une limite pratique en terme de performances, car il necessite un traitement 
sequentiel des donnees. La vitesse d'execution d'un programme concu selon ce modele est done 
directement lie a la vitesse d'execution des instructions, done a la vitesse du processeur de la machine 
utilisee. Lorsqu'un haut niveau de performance doit etre atteint, plusieurs solutions sont disponibles. 
Dans la pratique, on distingue trois solutions classiques. 

La premiere solution consiste simplement, pour augmenter la puissance d'une machine, a augmenter 
celle du processeur. Cela se traduit souvent par une augmentation de la frequence de ce processeur, 
technique que tout le monde connait. Les avantages de cette solution sont evidents : tous les pro- 
grammes beneficient directement de 1' augmentation de la puissance du processeur et n'ont pas a etre 
modifies. En revanche, cette technique atteindra un jour ou un autre ses limites en termes de couts de 
fabrication et de moyens techniques a mettre en oeuvre pour produire les processeurs. 

La deuxieme solution est d' augmenter le nombre de processeurs de la machine. Cette solution est tres 
simple, mais suppose que les programmes soient capables d'effectuer plusieurs calculs independants 
simultanement. En particulier, les traitements a effectuer doivent etre suffisamment independants et 
ne pas a avoir a attendre les donnees produites par les autres afin de pouvoir reellement etre exe- 
cutes en parallele. On quitte done le modele sequentiel, pour entrer dans un modele de traitement 
ou chaque processeur travaille en parallele (modele « MIMD », abreviation de 1' anglais « Multiple 
Instruction Multiple Data »). Cette technique est egalement souvent appelee le parallelisme de traite- 
ment. Malheureusement, pour un unique processus purement sequentiel, cette technique ne convient 
pas, puisque de toutes facons, les operations a executer ne le seront que par un seul processeur. 

Enfin, il existe une technique mixte, qui consiste a paralleliser les donnees. Les memes operations d' un 
programme sequentiel sont alors executees sur un grand nombre de donnees similaires. Les donnees 
sont done traitees par blocs, par un unique algorithme : il s' agit du parallelisme de donnees (« SIMD » 
en anglais, abreviation de « Single Instruction Multiple Data »). Cette solution est celle mise en oeuvre 
dans les processeurs modernes qui disposent de jeux d' instructions specialisees permettant d'effectuer 
des calculs sur plusieurs donnees simultanement (MMX, 3DNow et SSE pour les processeurs de 
type x86 par exemple). Bien entendu, cette technique suppose que le programme ait effectivement a 
traiter des donnees semblables de maniere similaire. Cette contrainte peut paraitre tres forte, mais, 
en pratique, les situations les plus consommatrices de ressources sont justement celles qui necessite 
la repetition d'un meme calcul sur plusieurs donnees. On citera par exemple tous les algorithmes 
de traitement de donnees multimedia, dont les algorithmes de compression, de transformation et de 
combinaison. 

Si 1' augmentation des performances des processeurs apporte un gain directement observable sur tous 
les programmes, ce n'est pas le cas pour les techniques de parallelisation. Le parallelisme de trai- 
tement est generalement accessible au niveau systeme, par 1' intermediate du multitache et de la 
programmation multithreadee. II faut done ecrire les programmes de telle sorte a beneficier de ce 
parallelisme de traitement, a l'aide des fonctions specifique au systeme d' exploitation. De meme, le 
parallelisme de donnees necessite la definition de types de donnees complexes, capables de represen- 
ter les blocs de donnees sur lesquels le programme doit travailler. Ces blocs de donnees sont cou- 
ramment geres comme des vecteurs ou des matrices, e'est-a-dire, en general, comme des tableaux de 
nombres. Le programme doit done utiliser ces types specifiques pour acceder a toutes les ressources 
de la machine. Cela necessite un support de la part du langage de programmation. 

Chaque environnement de developpement est susceptible de fournir les types de donnees permettant 
d'effectuer des traitements SIMD. Cependant, ces types dependent de 1' environnement utilise et en- 
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core plus de la plate-forme utilisee. La bibliotheque standard C++ permet d'eviter ces ecueils, car elle 
definit un type de donnee permettant de traiter des tableaux unidimensionnels d'objets, en assurant 
que les mecanismes d' optimisation propre aux plates-formes materielles et aux compilateurs seront 
effectivement utilises : les valarray. 

14.3.2.1. Fonctionnalites de base des valarray 

La classe valarray est une classe template capable de stocker un tableau de valeurs de son type 
template. II est possible de l'instancier pour tous les types de donnees pour lesquels les operations 
definies sur la classe valarray sont elles-memes definies. La bibliotheque standard C++ garantit que 
la classe valarray est ecrite de telle sorte que tous les mecanismes d' optimisation des compilateurs 
pourront etre appliques sur elle, afin d'obtenir des performances optimales. De plus, chaque imple- 
mentation est libre d'utiliser les possibilites de calcul parallele disponible sur chaque plate-forme, du 
moins pour les types pour lesquels ces fonctionnalites sont presentes. Par exemple, la classe valarray 
instanciee pour le type float peut utiliser les instructions specifiques de calcul sur les nombres flottants 
du processeur si elles sont disponibles. Toutefois, la norme n' impose aucune contrainte a ce niveau, 
et la maniere dont la classe valarray est implemented reste a la discretion de chaque fournisseur. 

La classe valarray fournit toutes les fonctionnalites necessaires a la construction des tableaux de 
valeurs, a leur initialisation, ainsi qu'a leur manipulation. Elle est declaree comme suit dans l'en-tete 

valarray : 

// Declaration des classes de selection de sous-tableau : 
class slice; 
class gslice; 

// Declaration de la classe valarray : 

template <class T> 

class valarray 

{ 

public : 

// Types des donnees : 

typedef T value_type; 

// Constructeurs et destructeurs : 
valarray ( ) ; 

explicit valarray (size_t taille); 
valarray (const T Svaleur, size_t taille); 
valarray (const T *tableau, size_t taille); 
valarray (const valarray Ssource); 
valarray (const mask_array<T> Ssource); 
valarray (const indirect_array<T> Ssource); 
valarray (const slice_array<T> Ssource); 
valarray (const gslice_array<T> ssource) ; 
-valarray ( ) ; 

// Operateurs d' affectation : 

valarray<T> Soperator= (const T Svaleur) ; 

valarray<T> Soperator= (const valarray<T> Ssource); 

valarray<T> Soperator= (const mask_array<T> Ssource); 

valarray<T> Soperator= (const indirect_array<T> Ssource) ; 

valarray<T> soperator= (const slice_array<T> ssource); 

valarray<T> Soperator= (const gslice_array<T> Ssource) ; 

// Operateurs d'acces aux elements : 
T operator[] (size_t indice) const; 
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T Soperator[] (size_t indice) ; 



// Operateurs de selection d 

valarray<T> operator 

mask_array<T> operator 

valarray<T> operator 

indirect_array<T> operator 

valarray<T> operator 

slice_array<T> operator 

valarray<T> operator 

gslice_array<T> operator 



e sous-ensemble du tableau : 

] (const valarray<bool> Smasque) const; 

] (const valarray<bool> Smasque) ; 

] (const valarray<size_t> Sindices) const; 

] (const valarray<size_t> Sindices) ; 

] (slice selecteur) const; 

] (slice selecteur) ; 

] (const gslice Sselecteur) const; 

] (const gslice Sselecteur) ; 



// Operateurs unaires : 

valarray<T> operator+() const; 

valarray<T> operator- () const; 

valarray<T> operator- () const; 

valarray<T> operator! () const; 



// Operateurs d' affectation composee : 

valarray<T> operator*= (const T Svaleur) ; 

valarray<T> operator*= (const valaray<T> stableau) 

valarray<T> operator/= (const T Svaleur) ; 

valarray<T> operator/= (const valaray<T> stableau) 

valarray<T> operator%= (const T Svaleur) ; 

valarray<T> operator%= (const valaray<T> stableau) 

valarray<T> operator+= (const T Svaleur) ; 

valarray<T> operator+= (const valaray<T> stableau) 

valarray<T> operator-= (const T Svaleur) ; 

valarray<T> operator-= (const valaray<T> stableau) 

valarray<T> operator A = (const T Svaleur) ; 

valarray<T> operator A = (const valaray<T> stableau) 

valarray<T> operatorS= (const T Svaleur) ; 

valarray<T> operators= (const valaray<T> stableau) 

valarray<T> operator | = (const T Svaleur) ; 

valarray<T> operator | = (const valaray<T> stableau) 

valarray<T> operator<<= (const T Svaleur); 

valarray<T> operator<<= (const valaray<T> Stableau); 

valarray<T> operator>>= (const T Svaleur); 

valarray<T> operator>>= (const valaray<T> stableau); 



// Operations specifiques : 

size_t sized const; 

T sum() const; 

T min ( ) const; 

T max ( ) const; 

valarray<T> shift (int) const; 

valarray<T> cshift(int) const; 

valarray<T> apply (T fonction(T)) const; 

valarray<T> apply (T fonction (const T &)) const; 

void resize (size_t taille, T initial=T ( ) ) ; 



Nous verrons dans la section suivante la signification des types slice, gslice, slice_array, gslice_array, 
mask_array et indirect_array. 

II existe plusieurs constructeurs permettant de creer et d'initialiser un tableau de valeurs. Le construc- 
ted par defaut initialise un tableau de valeur vide. Les autres constructeurs permettent d'initialiser 
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le tableau de valeur a partir d'une valeur d'initialisation pour tous les elements du valarray, ou d'un 
autre tableau contenant les donnees a affecter aux elements du valarray : 

// Construit un valarray de doubles : 
valarray<double> vl; 

// Initialise un valarray de doubles explicitement : 
double valeurs[] = {1.2, 3.14, 2.78, 1.414, 1.732}; 
valarray<double> v2 (valeurs, 

sizeof (valeurs) / sizeof (double) ) ; 

// Construit un valarray de 10 entiers initialises a 3 : 
valarray<int> v3(3, 10); 



Vous pouvez constater que le deuxieme argument des constructeurs qui permettent d' initialiser les 
valarray prennent un argument de type size_t, qui indique la taille du valarray. Une fois un valarray 
construit, il est possible de le redimensionner a l'aide de la methode resize. Cette methode prend en 
premier parametre la nouvelle taille du valarray et la valeur a affecter aux nouveaux elements dans le 
cas d'un agrandissement. La valeur par defaut est celle fournie par le constructeur par defaut du type 
des donnees contenues dans le valarray. La taille courante d'un valarray peut etre recuperee a tout 
moment grace a la methode size. 

Exemple 14-19. Modification de la taille d'un valarray 

#include <iostream> 
#include <valarray> 

using namespace std; 

int main (void) 
{ 

// Creation d'un valarray : 

valarray<double> v; 

cout << v.sizeO << endl; 

// Redimensionnement du valarray : 

v.resize (5, 3.14); 

cout << v.sizeO << endl; 

return 0; 
} 

Toutes les operations classiques des mathematiques peuvent etre appliquees sur un valarray pourvu 
qu'elles puissent l'etre egalement sur le type des donnees contenues par ce tableau. La definition de 
ces operations est tres simple : 1' operation du type de base est appliquee simplement a chaque element 
contenu dans le tableau de valeurs. 

La bibliotheque standard definit egalement les operateurs binaires necessaires pour effectuer les ope- 
rations binaires sur chaque element des valarray. En fait, ces operateurs sont classes en deux catego- 
ries, selon la nature de leurs arguments. Les operateurs de la premiere categorie permettent d' effectuer 
une operation entre deux valarray de meme dimension, en appliquant cette operation membre a 
membre. II s'agit done reellement d'une operation vectorielle dans ce cas. En revanche, les opera- 
teurs de la deuxieme categorie appliquent F operation avec une meme et unique valeur pour chaque 
donnee stockee dans le valarray. 



265 



Chapitre 14. Les types complementaires 

Exemple 14-20. Operations sur les valarray 

#include <iostream> 
#include <valarray> 

using namespace std; 

void affiche (const valarray<double> &v) 
{ 

size_t i; 

for (i=0; i<v.size(); ++i) 
cout << v[i] << " "; 

cout << endl; 



int main (void) 
{ 

// Construit deux valarray de doubles : 

double vl[] = {1.1, 2.2, 3.3}; 

double v2[] = {5.3, 4.4, 3.5}; 

valarray<double> vectl(vl, 3); 

valarray<double> vect2(v2, 3); 

valarray<double> res (3) ; 

// Effectue une somme membre a membre : 

res = vectl + vect2; 

affiche (res) ; 

// Calcule le sinus des membres du premier valarray 

res = sin (vectl ) ; 

affiche (res) ; 

return 0; 



Parmi les operateurs binaires que Ton peut appliquer a un valarray, on trouve bien entendu les ope- 
rateurs de comparaison. Ces operateurs, contrairement aux operateurs de comparaison habituels, ne 
renvoient pas un booleen, mais plutot un autre tableau de booleens. En effet, la comparaison de deux 
valarray a pour resultat le valarray des resultats des comparaisons membres a membres des deux 
valarray. 

La classe valarray dispose de methodes permettant d'effectuer diverses operations specifiques aux 
tableaux de valeurs. La methode sum permet d'obtenir la somme de toutes les valeurs stockees dans le 
tableau de valeur. Les methodes shift et cshif t permettent, quant a elles, de construire un nouveau 
valarray dont les elements sont les elements du valarray auquel la methode est appliquee, decales ou 
permutes circulairement d'un certain nombre de positions. Le nombre de deplacements effectues 
est passe en parametre a ces deux fonctions, les valeurs positives entrainant des deplacements vers 
la gauche et les valeurs negatives des deplacements vers la droite. Dans le cas des decalages les 
nouveaux elements introduits pour remplacer ceux qui n'ont pas eux-memes de remplacant prennent 
la valeur specifiee par le constructeur par defaut du type utilise. 

Exemple 14-21. Decalages et rotations de valeurs 

#include <iostream> 
#include <valarray> 

using namespace std; 

void affiche (const valarray<double> &v) 
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s i z e_t i ; 

for (i = 0; Kv.sizeO ; + + i) 

cout << v[i] << " "; 
cout << endl; 



int main (void) 



{ 



// Construit un valarray de doubles : 

double vl[] = {1.1, 2.2, 3.3, 4.4, 5.5}; 

valarray<double> vectl(vl, 5); 

valarray<double> res (5) ; 

// Effectue un decalage a gauche de deux positions : 

res = vectl . shift (2) ; 

af f iche (res) ; 

// Effectue une rotation de 2 positions vers la droite 

res = vectl . cshift (-2) ; 

af f iche (res) ; 

return 0; 



} 



Enfin, il existe deux methodes apply permettant d'appliquer une fonction a chaque element d'un 
valarray et de construire un nouveau valarray de meme taille et contenant les resultats. Ces deux 
surcharges peuvent travailler respectivement avec des fonctions prenant en parametre soit par valeur, 
soit par reference, l'objet sur lequel elles doivent etre appliquees. 



14.3.2.2. Selection multiple des elements d'un valarray 

Les elements d'un valarray peuvent etre accedes a l'aide de l'operateur d'acces aux elements de 
tableau ' [ ] '. La fonction af f iche des exemples du paragraphe precedent utilise cette fonctionnalite 
pour en recuperer la valeur. Cependant, les valarray dispose de mecanismes plus sophistiques pour 
manipuler les elements des tableaux de valeur en groupe, afin de beneficier de tous les mecanismes 
d' optimisation qui peuvent exister sur une plate-forme donnee. Grace a ces mecanismes, il est possible 
d'effectuer des operations sur des parties seulement d'un valarray ou d'ecrire de nouvelles valeurs 
dans certains de ses elements seulement. 

Pour effectuer ces selections multiples, plusieurs techniques sont disponibles. Cependant, toutes ces 
techniques se basent sur le meme principe, puisqu'elles permettent de filtrer les elements du valarray 
pour n'en selectionner qu'une partie seulement. Le resultat de ce filtrage peut etre un nouveau valarray 
ou une autre classe pouvant etre manipulee exactement de la meme maniere qu'un valarray. 

En pratique, il existe quatre manieres de selectionner des elements dans un tableau. Nous allons les 
detailler dans les sections suivantes. 



14.3.2.2. 1. Selection par un masque 

La maniere la plus simple est d'utiliser un masque de booleens indiquant quels elements doivent etre 
selectionnes ou non. Le masque de booleens doit obligatoirement etre un valarray de meme dimension 
que le valarray contenant les elements a selectionner. Chaque element est done selectionne en fonction 
de la valeur du booleen correspondant dans le masque. 

Une fois le masque construit, la selection des elements peut etre realisee simplement en fournissant 
ce masque a l'operateur [ ] du valarray contenant les elements a selectionner. La valeur retournee 
par cet operateur est alors une instance de la classe template mask_array, par l'intermediaire de 
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laquelle les elements selectionnes peuvent etre manipules. Pour les valarray constants cependant, la 
valeur retournee est un autre valarray, contenant une copie des elements selectionnes. 

La classe mask_array fournit un nombre limite d'operations. En fait, ses instances ne doivent etre 
utilisees que pour effectuer des operations simples sur les elements du tableau selectionne par le 
masque fourni a l'operateur [ ] . Les operations realisables seront decrites dans la Section 14.3.2.2.4. 

La selection des elements d'un tableau par 1' intermediate d'un masque est utilisee couramment avec 
les operateurs de comparaison des valarray, puisque ceux-ci renvoient justement un tel masque. II est 
done tres facile d' effectuer des operations sur les elements d'un valarray qui verifient une certaine 
condition. 

Exemple 14-22. Selection des elements d'un valarray par un masque 

#include <iostream> 
#include <valarray> 

using namespace std; 

void affiche (const valarray<int> &v) 
{ 

s i z e_t i ; 

for (i=0; i<v.size(); ++i) 
cout << v[i] << " "; 

cout << endl; 
} 

int main (void) 
{ 

// Construit un valarray d'entier : 

int valeurs [] = { 1, 5, 9, 4, 3, 7, 21, 32 }; 

valarray<int> vi (valeurs, 

sizeof (valeurs) / sizeof (int ) ) ; 

affiche (vi) ; 

// Multiplie par 2 tous les multiples de 3 : 

vi [ (vi % 3)==0] *= valarray<int> (2, vi.sizeO); 

affiche (vi) ; 

return ; 
} 



14.3.2.2.2. Selection par indexation explicite 

La selection des elements d'un valarray par un masque de booleens est explicite et facile a utiliser, 
mais elle souffre de plusieurs defauts. Premierement, il faut fournir un tableau de booleen de meme 
dimension que le valarray source. Autrement dit, il faut fournir une valeur booleenne pour tous les 
elements du tableau, meme pour ceux qui ne nous interessent pas. Ensuite, les elements selectionnes 
apparaissent systematiquement dans le meme ordre que celui qu'ils ont dans le valarray source. 

La bibliotheque standard C++ fournit done un autre mecanisme de selection, toujours explicite, mais 
qui permet de faire une reindexation des elements ainsi selectionnes. Cette fois, il ne faut plus fournir 
un masque a l'operateur [ ] , mais un valarray contenant directement les indices des elements selec- 
tionnes. Ces indices peuvent ne pas etre dans l'ordre croissant, ce qui permet done de rearranger 
l'ordre des elements ainsi selectionnes. 
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Exemple 14-23. Selection des elements d'un valarray par indexation 

#include <iostream> 
#include <valarray> 

using namespace std; 

void affiche (const valarray<int> &v) 
{ 

size_t i; 

for (i = 0; Kv.sizeO ; + + i) 
cout << v[i] << " "; 

cout << endl; 



int main (void) 
{ 

// Construit un valarray d'entier : 

int valeurs[] = { 1, 5, 9, 4, 3, 7, 21, 32 }; 

valarray<int> vi (valeurs, 

sizeof (valeurs) / sizeof (int )) ; 

affiche (vi) ; 

// Multiplie par 2 les elements d' indices 2, 5 et 7 : 

size_t indices [] = {2, 5, 7}; 

valarray<size_t> ind(indices, 

sizeof (indices) / sizeof (size_t) ) ; 

vi[ind] *= valarray<int> (2 , ind . size ( ) ) ; 

affiche (vi) ; 

return 0; 
} 

La valeur retournee par l'operateur de selection sur les valarray non constants est cette fois du type 
indirect_array. Comme pour la classe mask_array, les operations realisables par 1' intermediate de 
cette classe sont limitees et doivent servir uniquement a modifier les elements selectionnes dans le 
valarray source. 



14.3.2.2.3. Selection par indexation implicite 

Dans beaucoup de situations, les indices des elements selectionnes suivent un motif regulier et il n'est 
pas toujours pratique de specifier ce motif explicitement. La methode de selection precedents n'est 
dans ce cas pas tres pratique et il est alors preferable de selectionner les elements par un jeu d' indices 
decrits de maniere implicite. La bibliotheque fournit a cet effet deux classes utilitaires permettant de 
decrire des jeux d'indices plus ou moins complexes : la classe slice et la classe gslice. 

Ces deux classes definissent les indices des elements a selectionner a l'aide de plusieurs variables 
pouvant prendre un certain nombre de valeurs espacees par un pas d' incrementation fixe. La definition 
des indices consiste done simplement a donner la valeur de depart de l'indice de selection, le nombre 
de valeurs a generer pour chaque variable et le pas qui separe ces valeurs. Les variables de controle 
commencent toutes leur iteration a partir de la valeur nulle et prennent comme valeurs successives les 
multiples du pas qu'elles utilisent. 

Note : En realite, la classe slice est un cas particulier de la classe gslice qui n'utilise qu'une seule 
variable de controle pour definir les indices. Les slice ne sont done rien d'autre que des gslice 
unidimensionnels. 
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Le terme de gslice provient de I'anglais « Generalized Slice », qui signifie bien que les gslice sont 
des slice etendues a plusieurs dimensions. 



La classe slice est relativement facile a utiliser, puisqu'il suffit de specifier la valeur de depart de 
l'indice, le nombre de valeurs a generer et le pas qui doit les separer. Elle est declaree comme suit 
dans l'en-tete valarray : 

class slice 

{ 

public : 

slice ( ) ; 

slice (size_t debut, size_t nombre, size_t pas); 

// Accesseurs : 
size_t start () const; 
size_t sized const; 
size_t stride () const; 

}; 



Exemple 14-24. Selection par indexation implicite 

#include <iostream> 
#include <valarray> 

using namespace std; 

void affiche (const valarray<int> &v) 
{ 

s i z e_t i ; 

for (i=0; i<v.size(); ++i) 
cout << v[i] << " "; 

cout << endl; 
} 

int main (void) 
{ 

// Construit un valarray d'entier : 

int valeurs[] = { 1, 5, 9, 4, 3, 7, 21, 32 }; 

valarray<int> vi (valeurs, 8); 

affiche (vi) ; 

// Multiplie par 2 un element sur 3 a partir du deuxieme : 

slice sel (1, 3, 3) ; 

vi[sel] *= valarray<int> (2, vi.sizeO); 

affiche (vi) ; 

// Multiplie par 2 un element sur 3 a partir du deuxieme : 

slice sel (1, 3, 3) ; 

vi[sel] *= valarray<int> (2, vi.sizeO); 

affiche (vi) ; 

return 0; 
} 

La classe gslice est en revanche un peu plus difficile d'emploi puisqu'il faut donner le nombre de 
valeurs et le pas pour chaque variable de controle. Le constructeur utilise prend done en deuxieme et 
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troisieme parametres non plus deux valeurs de type size_t, mais deux valarray de size_t. La declaration 
de la classe gslice est done la suivante : 

class gslice 

{ 

public : 

gslice ( ) ; 

gslice (size_t debut, 

const valarray<size_t> nombres, 
const valarray<size_t> pas); 

// Accesseurs : 
size_t start () const; 
valarray<size_t> sized const; 
valarray<size_t> stride () const; 

}; 



Les deux valarray determinant le nombre de valeurs des variables de controle et leurs pas doivent bien 
entendu avoir la meme taille. L'ordre dans lequel les indices des elements selectionnes sont generes 
par la classe gslice est celui obtenu en faisant varier en premier les dernieres variables caracterisees 
par les valarray fournis lors de sa construction. Par exemple, une classe gslice utilisant trois variables 
prenant respectivement 2, 3 et 5 valeurs et variant respectivement par pas de 3, 1 et 2 unites, en partant 
de 1'indice 2, generera les indices suivants : 

2, 4, 6, 8, 10, 

3, 5, 7, 9, 11, 

4, 6, 8, 10, 12, 

5, 7, 9, 11, 13, 

6, 8, 10, 12, 14, 

7, 9, 11, 13, 15 

La variable prenant cinq valeurs et variant de deux en deux est done celle qui evolue le plus vite. 

Comme vous pouvez le constater avec l'exemple precedent, un meme indice peut apparaitre plusieurs 
fois dans la serie definie par une classe gslice. La bibliotheque standard C++ n'effectue aucun controle 
a ce niveau : il est done du ressort du programmeur de bien faire attention a ce qu'il fait lorsqu'il 
manipule des jeux d'indices degeneres. 

Comme pour les autres techniques de selection, la selection d' elements d'un valarray non constant par 
1' intermediate des classes slice et gslice retourne une instance d'une classe particuliere permettant de 
prendre en charge les operations de modification des elements ainsi selectionnes. Pour les selections 
simples realisees avec la classe slice, l'objet retourne est de type slice_array. Pour les selections 
realisees avec la classe gslice, le type utilise est le type gslice_array. 



14.3.2.2.4. Operations realisables sur les selections multiples 

Comme on l'a vu dans les sections precedentes, les selections multiples realisees sur des objets non 
constants retournent des instances des classes utilitaires mask_array, indexed_array, slice_array et 
gslice_array. Ces classes referencent les elements ainsi selectionnes dans le valarray source, permet- 
tant ainsi de les manipuler en groupe. Cependant, ce ne sont pas des valarray complets et, en fait, ils 
ne doivent etre utilises, de maniere generale, que pour effectuer une operation d' affectation sur les 
elements selectionnes. Ces classes utilisent done une interface restreinte de celle de la classe valarray, 
qui n'accepte que les operateurs d' affectation sur les elements qu'elles represented. 
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Par exemple, la classe mask_array est declaree comme suit dans l'en-tete valarray 

template <class T> 
class mask_array 
{ 
public : 

typedef T value_type; 

~mask_array ( ) ; 

// Operateurs d' affectation et d' affectation composees : 

void operator= (const valarray<T> &) const; 

void operator*= (const valarray<T> &) const; 

void operator/= (const valarray<T> &) const; 

void operator%= (const valarray<T> &) const; 

void operator+= (const valarray<T> &) const; 

void operator-= (const valarray<T> &) const; 

void operator A = (const valarray<T> &) const; 

void operator&= (const valarray<T> &) const; 

void operator | = (const valarray<T> &) const; 

void operator<<= (const valarray<T> &) const; 

void operator>>= (const valarray<T> &) const; 

void operator= (const T Svaleur) ; 



Tous ces operateurs permettent d'affecter aux elements de la selection represented par cette classe 
les valeurs specifiees par leur parametre. En general, ces valeurs doivent etre fournies sous la forme 
d'un valarray, mais il existe egalement une surcharge de l'operateur d' affectation permettant de leur 
affecter a tous une meme valeur. 

Note : Les selections realisees sur les valarray constants ne permettent bien entendu pas de 
modifier leurs elements. Les objets retoumes par l'operateur n lors des selections multiples 
sur ces objets sont done des valarray classiques contenant une copie des valeurs des elements 
selectionnes. 



14.3.3. Les champs de bits 

De tous les types de donnees qu'un programme peut avoir besoin de stacker, les booleens sont certai- 
nement l'un des plus importants. En effet, les programmes doivent souvent representer des proprietes 
qui sont soit vraies, soit fausses. Apres tout, la base du traitement de l'information telle qu'il est 
realise par les ordinateurs est le bit, ou chiffre binaire... 

II existe plusieurs manieres de stacker des booleens dans un programme. La technique la plus simple 
est bien entendu d'utiliser le type C++ natif bool, qui ne peut prendre que les valeurs true et false. 
Les programmes plus vieux utilisaient generalement des entiers et des constantes predefinies ou en- 
core une enumeration. Malheureusement, toutes ces techniques souffrent du gros inconvenient que 
chaque information est stockee dans le type sous-jacent au type utilise pour representer les booleens 
et, dans la plupart des cas, ce type est un entier. Cela signifie que pour stocker un bit, il faut reserver un 
mot memoire complet. Meme en tenant compte du fait que la plupart des compilateurs C++ stockent 
les variables de type bool dans de simples octets, la deperdition reste dans un facteur 8. Bien entendu, 



272 



Chapitre 14. Les types complementaires 

cela n'est pas grave si 1'on n'a que quelques bits a stocker, mais si le programme doit manipuler un 
grand nombre d' informations booleennes, cette technique est a proscrire. 

Nous avons vu dans la Section 3.1.4 qu'il est possible de definir des champs de bits en attribuant 
un nombre de bits fixe a plusieurs identificateurs de type entier. Cette solution peut permettre 
d'economiser de la memoire, mais reste malgre tout relativement limitee si un grand nombre de bits 
doit etre manipule. Afin de resoudre ce probleme, la bibliotheque standard C++ fournit la classe 
template bitset qui, comme son nom l'indique, encapsule des champs de bits de tailles arbitraires. 
Le parametre template est de type size_t et indique le nombre de bits que le champ de bits 
encapsule contient. 

Note : Vous noterez que cela impose de connaitre a la compilation la taille du champ de bits. 
Cela est regrettable et limite serieusement I'interet de cette classe. Si vous devez manipuler des 
champs de bits de taille dynamique, vous devrez ecrire vous-meme une classe d'encapsulation 
dynamique des champs de bits. 



La classe bitset est declaree comme suit dans l'en-tete bitset 

template <size_t N> 
class bitset 



public : 

class reference; 



// Classe permettant de manipuler les bits. 



// Les constructeurs : 

bitset ( ) ; 

bitset (unsigned long val); 

template<class charT, class traits, class Allocator> 

explicit bitset ( 

const basic_string<charT, traits, Allocator> Schaine, 

typename basic_string<charT, traits, Allocator> : : size_type debut = 0, 
typename basic_string<charT, traits, Allocator> : : size_type taille = 
basic_string<charT, traits, Allocator> : : npos ) ; 

// Les fonctions de conversion : 

unsigned long to_ulong() const; 

template <class charT, class traits, class Allocator> 

basic_string<charT, traits, Allocator> to_string() const; 



// Les operateurs de manipulation : 

bitset<N> &operator&= (const bitset<N> &) 

bitset<N> soperator | = (const bitset<N> &) 

bitset<N> soperator A = (const bitset<N> &) 

bitset<N> &operator<<= (size_t pos); 

bitset<N> &operator>>= (size_t pos); 

bitset<N> operator<< (size_t pos) const; 

bitset<N> operator>> (size_t pos) const; 
bitset<N> operator- () const; 

bitset<N> sset () ; 

bitset<N> sset(size_t pos, bool val = true) 

bitset<N> sresetO; 

bitset<N> sreset (size_t pos); 

bitset<N> sflip ; 

bitset<N> sflip (size_t pos); 
bool test(size_t pos) const; 
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reference operator [] (size_t pos) ; // for b[i]; 

// Les operateurs de comparaison : 

bool operator== (const bitset<N> &rhs) const; 

bool operator ! = (const bitset<N> &rhs) const; 

// Les fonctions de test : 
size_t count () const; 
size_t sized const; 
bool any ( ) const; 
bool none ( ) const; 



La construction d'un champ de bits necessite de connaitre le nombre de bits que ce champ doit conte- 
nir afin d'instancier la classe template bitset. Les differents constructeurs permettent d' initialiser le 
champ de bits en affectant la valeur nulle a tous ses bits ou en les initialisant en fonction des para- 
metres du constructeur. Le deuxieme constructeur affectera aux premiers bits du champ de bits les 
bits correspondant de l'entier de type unsigned long fourni en parametre, et initialisera les autres bits 
du champ de bits a la valeur si celui-ci contient plus de bits qu'un unsigned long. Le troisieme 
constructeur initialise le champ de bits a partir de sa representation sous forme de chaine de carac- 
teres ne contenant que des '0' ou des 'l'. Cette representation doit etre stockee dans la basic_string 
fournie en premier parametre, a partir de la position debut et sur une longueur de taille caracteres. 
Cette taille peut etre inferieure a la taille du champ de bits. Dans ce cas, le constructeur considerera 
que les bits de poids fort sont tous nuls et initialisera les premiers bits du champ avec les valeurs lues 
dans la chaine. Notez bien que les premiers caracteres de la chaine de caracteres represented les bits 
de poids fort, cette chaine est done parcourue en sens inverse lors de 1' initialisation. Ce constructeur 
est susceptible de lancer une exception out_of_range si le parametre debut est superieur a la taille 
de la chaine ou une exception invalid_argument si l'un des caracteres utilises est different des 
caracteres '0' ou 'l'. 

Comme vous pouvez le constater d'apres la declaration, la classe bitset fournit egalement des me- 
thodes permettant d'effectuer les conversions inverses de celles effectuees par les constructeurs. La 
methode to_ulong renvoie done un entier de type unsigned long correspondant a la valeur des pre- 
miers bits du champ de bits, et la methode template to_string renvoie une chaine de caracteres 
contenant la representation du champ de bits sous la forme d'une suite de caracteres '0' et '1'. La 
classe bitset fournit egalement des surcharges des operateurs operator<< et operator>> pour les 
flux d' entree / sortie de la bibliotheque standard. 

Exemple 14-25. Utilisation d'un bitset 

#include <iostream> 
#include <bitset> 
#include <string> 

using namespace std; 

int main (void) 
{ 

// Construit un champ de bits : 

string s ("100110101") ; 

bitset<32> bs (s) ; 

// Affiche la valeur en hexadecimal de l'entier associe : 

cout << hex << showbase << bs . to_ulong ( ) << endl; 

// Affiche la valeur sous forme de chaine de caracteres : 
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string t; 

t = bs . to_string<string: : value_type, string :: traits_type, 

string: : allocator_type> ( ) ; 
cout << t << endl; 

// Utilise directement << sur le flux de sortie : 
cout << bs << endl; 
return 0; 



Note : La methode to_string est une fonction template ne prenant pas de parametres. Le com- 
pilateur ne peut done pas realiser une instanciation implicite lors de son appel. Par consequent, 
vous devrez fournir la liste des parametres template explicitement si vous desirez utiliser cette 
methode. II est generalement plus simple d'ecrire la valeur du bitset dans un flux standard. 

Les modificateurs de format de flux hex et showbase ont pour but d'effectuer I'affichage des 
entiers sous forme hexadecimale. La personnalisation des flux d'entree / sortie sera decrite en 
detail dans le Chapitre 15. 



Les operateurs de manipulation des champs de bits ne posent pas de probleme particulier puisqu'ils 
ont la meme semantique que les operateurs standards du langage, a ceci pres qu'ils travaillent sur 
l'ensemble des bits du champ en meme temps. Le seul operateur qui demande quelques explications 
est l'operateur d'acces unitaire aux bits du champ, a savoir l'operateur operator [ ] . En effet, cet 
operateur ne peut pas retourner une reference sur le bit designe par son argument puisqu'il n'y a pas 
de type pour representer les bits en C++. Par consequent, la valeur retournee est en realite une instance 
de la sous-classe reference de la classe bitset. Cette sous-classe encapsule l'acces individuel aux bits 
d'un champ de bits et permet de les utiliser exactement comme un booleen. En particulier, il est 
possible de faire des tests directement sur cette valeur ainsi que de lui affectuer une valeur booleenne. 
Enfin, la sous-classe reference dispose d'une methode flip dont le role est d'inverser la valeur du bit 
auquel 1'objet reference donne acces. 

La classe template bitset dispose egalement de methodes specifiques permettant de manipuler les 
bits sans avoir recours a l'operateur operator [ ] . II s'agit des methodes test, set, reset et flip. 
La premiere methode permet de recuperer la valeur courante d'un des bits du champ de bits. Elle 
prend en parametre le numero de ce bit et renvoie un booleen valant true si le bit est a 1 et false 
sinon. La methode set permet de reinitialiser le champ de bits complet en positionnant tous ses bits a 
1 ou de fixer manuellement la valeur d'un bit particulier. La troisieme methode permet de reinitialiser 
le champ de bits en annulant tous ses bits ou d'annuler un bit specifique. Enfin, la methode flip 
permet d'inverser la valeur de tous les bits du champ ou d'inverser la valeur d'un bit specifique. 
Les surcharges des methodes qui travaillent sur un seul bit prennent toutes en premier parametre la 
position du bit dans le champ de bits. 

Exemple 14-26. Manipulation des bits d'un champ de bits 

#include <iostream> 
#include <string> 
#include <bitset> 

using namespace std; 

int main (void) 
{ 

// Construit un champ de bits : 

string s ("10011010") ; 

bitset<8> bs (s) ; 
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cout << bs << endl; 

// Inverse le champ de bits : 

bs.flipO ; 

cout << bs << endl; 

// Fixe le bit de poids fort : 

bs . set (7, true) ; 

cout << bs << endl; 

// Annule le 7eme bit a l'aide d'une reference de bit 

bs [ 6] = false; 

cout << bs << endl; 

// Anule le bit de poids faibe : 

bs . reset (0) ; 

cout << bs << endl; 

return 0; 



} 



Enfin, la classe bitset fournit quelques methodes permettant d'effectuer des tests sur les champs de 
bits. Outre les operateurs de comparaison classiques, elle fournit les methodes count, size, any et 
none. La methode count renvoie le nombre de bits positionnes a 1 dans le champ de bits. La methode 
size renvoie quant a elle la taille du champ de bits, c'est-a-dire la valeur du parametre template 
utilisee pour instancier la classe bitset. Enfin, les methodes any et none renvoient true si un bit au 
moins du champ de bits est positionne ou s'ils sont tous nuls. 
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Nous avons vu dans la Section 8.12 un exemple d' application des classes de flux d'entree / sortie de 
la bibliotheque pour les entrees / sorties standards des programmes. En realite, ces classes de gestion 
des flux s'integrent dans une hierarchie complexe de classes permettant de manipuler les flux d'entree 
/ sortie et pas seulement pour les entrees / sorties standards. 

En effet, afin de faciliter la manipulation des flux d'entree / sortie, la bibliotheque standard C++ 
fournit tout un ensemble de classes template. Ces classes sont parametrees par le type de base des 
caracteres qu'elles manipulent. Bien entendu, les types de caracteres les plus utilises sont les type 
char et wchar_t, mais il est possible d'utiliser a priori n'importe quel autre type de donnee pour lequel 
une classe de traits char_traits est definie. 

Ce chapitre a pour but de detailler cette hierarchie de classes. Les principes de base et 1' architecture 
generate des flux C++ seront done abordes dans un premier temps, puis les classes de gestion des 
tampons seront traitees. Les classes generiques de gestion des flux d'entree / sortie seront ensuite 
decrites, et ce sera enfin le tour des classes de gestion des flux orientes chaines de caracteres et des 
classes de gestion des flux orientes fichiers. 



15.1. Notions de base et presentation generale 

Les classes de la bibliotheque d'entree / sortie de la bibliotheque standard se subdivisent en deux 
categories distinctes. 

La premiere categorie regroupe les classes de gestion des tampons d'entree / sortie. Ces classes sont 
au nombre de trois : la classe template basic_stringbuf, qui permet de realiser des tampons pour les 
flux orientes chaines de caracteres, la classe template basic_filebuf, qui prend en charge les tampons 
pour les flux orientes fichiers, et leur classe de base commune, la classe template basic_streambuf. 
Le role de ces classes est principalement d'optimiser les entrees / sorties en intercalant des tampons 
d'entree / sortie au sein meme du programme. Ce sont principalement des classes utilitaires, qui sont 
utilisees en interne par les autres classes de la bibliotheque d'entree / sortie. 

La deuxieme categorie de classes est de loin la plus complexe, puisqu'il s'agit des classes de gestion 
des flux eux-memes. Toutes ces classes derivent de la classe template basic_ios (elle-meme derivee 
de la classe de base ios_base, qui definit tous les types et les constantes utilises par les classes de 
flux). La classe basic_ios fournit les fonctionnalites de base des classes de flux et, en particulier, elle 
gere le lien avec les tampons d'entree / sortie utilises par le flux. De cette classe de base derivent 
des classes specialisees respectivement pour les entrees ou pour les sorties. Ainsi, la classe tem- 
plate basic_istream prend en charge toutes les operations des flux d'entree et la classe basic_ostream 
toutes les operations des flux de sortie. Enfin, la bibliotheque standard definit la classe template ba- 
sic_iostream, qui regroupe toutes les fonctionnalites des classes basic_istream et basic_ostream et 
dont derivent toutes les classes de gestion des flux mixtes. 

Les classes basic_istream, basic_ostream et basic_iostream fournissent les fonctionnalites de base 
des flux d'entree / sortie. Ce sont done les classes utilisees pour implementer les flux d'entree / sortie 
standards du C++ cin, cout, cerr et clog, que Ton a brievement presentes dans la Section 8.12. 
Cependant, ces classes ne prennent pas en charge toutes les specificites des medias avec lesquels des 
flux plus complexes peuvent communiquer. Par consequent, des classes derivees, plus specialisees, 
sont fournies par la bibliotheque standard. Ces classes prennent en charge les entrees / sorties sur 
fichier et les flux orientes chaines de caracteres. 

La bibliotheque standard fournit done deux jeux de classes specialisees pour les entrees / sorties 
dans des fichiers et dans des chaines de caracteres. Pour chacune des classes de base basic_istream, 
basic_ostream et basic_iostream il existe deux classes derivees, une pour les fichiers, et une pour 
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les chaines de caracteres. Par exemple, les classes template basic_ifstream et basic_istringstream 
derivent de la classe basic_istream et prennent en charge respectivement les flux d' entree a partir de 
fichiers et les flux d'entree a partir de chaines de caracteres. De meme, la bibliotheque standard definit 
les classes template basic_ofstream et basic_ostringstream, derivees de la classe basic_ostream, 
pour les flux de sortie dans des fichiers ou dans des chaines de caracteres, et les classes template 
basic_fstream et basic_stringstream, derivees de la classe basic_iostream, pour les flux d'entree / 
sortie sur les fichiers et les chaines de caracteres. 

Note : Cette hierarchie de classes est assez complexe et peut paraitre etrange au niveau 
des classes des flux mixtes. En effet, la classe basic_fstream ne derive pas des classes 
basic_ifstream et basic_ofstream mais de la classe basic_iostream, et c'est cette classe qui 
derive des classes basic_istream et basic_ostream. De meme, la classe basic_stringstream 
ne derive pas des classes basic_istringstream et basic_ostringstream, mais de la classe 
basic iostream. 



Comme il Fa deja ete dit, toutes ces classes template peuvent etre instanciees pour n'importe quel 
type de caractere, pourvu qu'une classe de traits char_traits soit definie. Cependant, en pratique, il 
n'est courant d'instancier ces classes que pour les types de caracteres de base du langage, a savoir les 
types char et wchar_t. 

Historiquement, les classes d'entree / sortie des bibliotheques fournies avec la plupart des implemen- 
tations n'etaient pas template et ne permettaient de manipuler que des flux bases sur le type de 
caractere char. Les implementations disposant de classes de flux d'entree / sortie capables de ma- 
nipuler les caracteres de type wchar_t etaient done relativement rares. A present, toutes ces classes 
sont definies comme des instances des classes template citees ci-dessus. Par souci de compatibilite, 
la bibliotheque standard C++ definit tout un jeu de types pour ces instances qui permettent aux pro- 
grammes utilisant les anciennes classes de fonctionner. Ces types sont declares de la maniere suivante 
dans l'en-tete iosf wd (mais sont definis dans leurs en-tetes respectifs, que Ton decrira plus tard) : 

// Types de base des tampons : 
typedef basic_streambuf <char> streambuf; 
typedef basic_streambuf <wchar_t> wstreambuf; 
typedef basic_stringbuf <char> stringbuf; 
typedef basic_stringbuf <wchar_t> wstringbuf; 
typedef basic_f ilebuf <char> filebuf; 
typedef basic_f ilebuf <wchar_t> wfilebuf; 

// Types de base des flux d'entree / sortie : 
typedef basic_ios<char> ios; 
typedef basic_ios<wchar_t> wios; 

// Types des flux d'entree / sortie standards : 
typedef basic_istream<char> istream; 
typedef basic_istream<wchar_t> wistream; 
typedef basic_ostream<char> ostream; 
typedef basic_ostream<wchar_t> wostream; 
typedef basic_iostream<char> iostream; 
typedef basic_iostream<wchar_t> wiostream; 

// Types des flux orientes fichiers : 
typedef basic_if stream<char> ifstream; 
typedef basic_if stream<wchar_t> wifstream; 
typedef basic_of stream<char> ofstream; 
typedef basic_of stream<wchar_t> wofstream; 
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typedef basic_f stream<char> fstream; 
typedef basic_f stream<wchar_t> wfstream; 

// Types des flux orientes chalnes de caracteres : 

typedef basic_istringstream<char> istringstream; 

typedef basic_istringstream<wchar_t> wistringstream; 

typedef basic_ostringstream<char> ostringstream; 

typedef basic_ostringstream<wchar_t> wostringstream; 

typedef basic_stringstream<char> stringstream; 

typedef basic_stringstream<wchar_t> wstringstream; 



Les objets cin, cout, cerr et clog sont done des instances des classes istream et ostream, qui sont 
associees aux flux d'entree / sortie standards du programme. En fait, la bibliotheque standard definit 
egalement des versions capables de manipuler des flux bases sur le type wchar_t pour les programmes 
qui desirent travailler avec des caracteres larges. Ces objets sont respectivement wcin (instance de 
wistream), wcout, wcerr et wclog (instances de wostream). Tous ces objets sont initialises par la 
bibliotheque standard automatiquement lorsqu'ils sont utilises pour la premiere fois, et sont done 
toujours utilisables. 

Note : En realite, sur la plupart des systemes, les flux d'entree / sortie standards sont les premiers 
descripteurs de fichiers que le systeme attribue automatiquement aux programmes lorsqu'ils sont 
lances. En toute logique, les objets cin, cout, cerr et clog devraient done etre des instances de 
classes de gestion de flux orientes fichiers. Cependant, ces fichiers ne sont pas nommes d'une 
part et, d'autre part, tous les systemes ne gerent pas les flux d'entree / sortie standards de la 
meme maniere. Ces objets ne sont done pas toujours des flux sur des fichiers et la bibliotheque 
standard C++ ne les definit par consequent pas comme tels. 



15.2. Les tampons 



Les classes de gestion des tampons de la bibliotheque standard C++ se situent au coeur des operations 
d'ecriture et de lecture sur les flux de donnees physiques qu'un programme est susceptible de mani- 
puler. Bien qu'elles ne soient quasiment jamais utilisees directement par les programmeurs, e'est sur 
ces classes que les classes de flux s'appuient pour effectuer les operations d'entree sortie. II est done 
necessaire de connaitre un peu leur mode de fonctionnement. 

15.2.1. Generalites sur les tampons 

Un tampon, egalement appele cache, est une zone memoire dans laquelle les operations d'ecriture et 
de lecture se font et dont le contenu est mis en correspondance avec les donnees d'un media physique 
sous-jacent. Les mecanismes de cache ont essentiellement pour but d'optimiser les performances 
des operations d'entree / sortie. En effet, l'acces a la memoire cache est generalement beaucoup 
plus rapide que l'acces direct au support physique ou au media de communication. Les operations 
effectuees par le programme se font done, la plupart du temps, uniquement au niveau du tampon, et 
ce n'est que dans certaines conditions que les donnees du tampon sont effectivement transmises au 
media physique. Le gain en performance peut intervenir a plusieurs niveau. Les cas les plus simples 
etant simplement lorsqu'une donnee ecrite est ecrasee peu de temps apres par une autre valeur (la 
premiere operation d'ecriture n'est alors jamais transmise au media) ou lorsqu'une donnee est lue 
plusieurs fois (la meme donnee est renvoyee a chaque lecture). Bien entendu, cela suppose que les 
donnees stockees dans le tampon soient coherentes avec les donnees du media, surtout si les donnees 
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sont accedees au travers de plusieurs tampons. Tout mecanisme de gestion de cache permet done de 
vider les caches (e'est-a-dire de forcer les operations d'ecriture) et de les invalider (e'est-a-dire de 
leur signaler que leurs donnees sont obsoletes et qu'une lecture physique doit etre faite si on cherche 
a y acceder). 

Les mecanismes de memoire cache et de tampon sont tres souvent utilises en informatique, a tous les 
niveaux. On trouve des memoires cache dans les processeurs, les controleurs de disque, les graveurs 
de CD, les pilotes de peripheriques des systemes d'exploitation et bien entendu dans les programmes. 
Chacun de ces caches contribue a 1' amelioration des performances globales en retardant au maximum 
la realisation des operations lentes et en optimisant les operations de lecture et d'ecriture (souvent en 
les effectuant en groupe, ce qui permet de reduire les frais de communication ou d' initialisation des 
peripheriques). II n'est done absolument pas surprenant que la bibliotheque standard C++ utilise elle 
aussi la notion de tampon dans toutes ses classes d'entree / sortie... 



15.2.2. La classe basic_streambuf 

Les mecanismes de base des tampons de la bibliotheque standard sont implemented dans la classe 
template basic_streambuf. Cette classe n'est pas destinee a etre utilisee telle quelle car elle ne sait 
pas communiquer avec les supports physiques des donnees. En fait, elle ne peut etre utilisee qu'en 
tant que classe de base de classes plus specialisees, qui elles fournissent les fonctionnalites d'acces 
aux medias par l'intermediaire de fonctions virtuelles. La classe basic_streambuf appelle done ces 
methodes en diverses circonstances au sein des traitements effectues par son propre code de gestion 
du tampon, aussi bien pour signaler les changements d'etat de celui-ci que pour demander l'ecriture 
ou la lecture des donnees dans la sequence sous controle. 

La classe basic_streambuf fournit done une interface publique permettant d'acceder aux donnees du 
tampon d'un cote et definit 1' interface de communication avec ses classes filles par l'intermediaire de 
ses methodes virtuelles de l'autre cote. Bien entendu, ces methodes virtuelles sont toutes declarees 
en zone protegee afin d'eviter que Ton puisse les appeler directement, tout en permettant aux classes 
derivees de les redefinir et d'y acceder. 

En interne, la classe basic_streambuf encapsule deux tampons, un pour les ecritures et un pour les 
lectures. Cependant, ces tampons accedent a la meme memoire et a la meme sequence de donnees 
physiques. Ces deux tampons peuvent etre utilises simultanement ou non, suivant la nature de la 
sequence sous controle et suivant le flux qui utilise le tampon. Par exemple, les flux de sortie n'utilisent 
que le tampon en ecriture, et les flux d'entree que le tampon en lecture. 

La classe basic_streambuf gere ses tampons d'entree et de sortie a l'aide d'une zone de memoire 
interne qui contient un sous-ensemble des donnees de la sequence sous controle. Les deux tampons 
travaillent de maniere independante sur cette zone de memoire et sont chacun represented a l'aide 
de trois pointeurs. Ces pointeurs contiennent respectivement l'adresse du debut de la zone memoire 
du tampon, son adresse de fin et l'adresse de la position courante en lecture ou en ecriture. Ces 
pointeurs sont completement geres en interne par la classe basic_streambuf, mais les classes derivees 
peuvent y acceder et les modifier en fonction de leurs besoins par l'intermediaire d'accesseurs. Les 
pointeurs d'un tampon peuvent parfaitement etre nuls si celui-ci n'est pas utilise. Toutefois, si le 
pointeur referencant la position courante n'est pas nul, ses pointeurs associes ne doivent pas 1'etre et 
la position courante referencee doit obligatoirement se situer dans une zone memoire definie par les 
pointeurs de debut et de fin du tampon. 

La classe basic_streambuf est declaree comme suit dans l'en-tete streambuf : 

template <class charT, class traits = 

char_traits<charT> > 
class basic_streambuf 
{ 
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public : 

// Les types de base : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

typedef traits traits_type; 

// Les methodes publiques utilisables par les classes de flux 

// Les methodes de gestion des locales : 
locale pubimbue (const locale sloe); 
locale getlocO const; 

// Les methodes de gestion du tampon : 
basic_streambuf <char_type, traits> * 

pubsetbuf (char_type* s, streamsize n) ; 
pos_type pubseekof f (of f_type off, ios_base : : seekdir sens, 

ios_base : : openmode mode = ios_base::in | ios_base : : out ) ; 
pos_type pubseekpos (pos_type sp, 

ios_base :: openmode mode = ios_base::in | ios_base : : out ) ; 
int pubsync ( ) ; 

// Methodes d'acces au tampon en lecture : 
streamsize in_avail(); 
int_type sgetc(); 
int_type sbumpc () ; 
int_type snextcO; 
streamsize sgetn (char_type *s, streamsize n) ; 

// Methode d'annulation de lecture d'un caractere : 
int_type sputbackc (char_type c); 
int_type sungetc(); 

// Methode d'acces en ecriture : 

int_type sputc (char_type c) ; 

streamsize sputn (const char_type *s, streamsize n); 

// Le destructeur : 
virtual ~basic_streambuf ( ) ; 

protected: 

// Les methodes protected utilisables par 
// les classes derivees : 

// Le constructeur : 
basic_streambuf ( ) ; 

// Methodes d'acces aux pointeurs du tampon de lecture : 
char_type *eback() const; 
char_type *gptr() const; 
char_type *egptr() const; 
void gbump(int n) ; 

void setg (char_type *debut, char_type *suivant, 
char_type *fin); 

// Methodes d'acces aux pointeurs du tampon d' ecriture : 
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char_type *pbase() const; 

char_type *pptr() const; 

char_type *epptr() const; 

void pbump(int n) ; 

void setp (char_type *debut, char_type *f in) ; 

// Les methodes protected virtuelles, que les classes 
// derivees doivent implementer : 

virtual void imbue (const locale Sloe); 
virtual basic_streambuf <char_type, traits>* 

setbuf (char_type *s, streamsize n) ; 
virtual pos_type seekof f (of f_type off, ios_base : : seekdir sens, 

ios_base : : openmode mode = ios_base::in | ios_base : : out ) ; 
virtual pos_type seekpos (pos_type sp, 

ios_base :: openmode mode = ios_base::in | ios_base : : out ) ; 
virtual int sync () ; 
virtual int showmanyc ( ) ; 

virtual streamsize xsgetn (char_type *s, streamsize n) ; 
virtual int_type underflow!] ; 
virtual int_type uflow(); 

virtual int_type pbackf ail (int_type c = traits :: eof ()) ; 
virtual streamsize xsputn (const char_type* s, streamsize n) ; 
virtual int_type overflow (int_type c = traits :: eof ()) ; 



Comme vous pouvez le constater, le constructeur de la classe basic_streambuf est declare en zone 
protected, ce qui empeche quiconque de l'instancier. C'est normal, puisque cette classe n'est desti- 
nee a etre utilisee qu'en tant que classe de base d'une classe specialisee pour un media specifique. En 
revanche, les methodes virtuelles ne sont pas pures, car elles fournissent un comportement par defaut 
qui conviendra dans la plupart des cas. 

L' interface publique comprend des methodes d'ordre generate et des methodes permettant d'effectuer 
les operations d'ecriture et de lecture sur les tampons encapsules par la classe basic_streambuf. Pour 
les distinguer des methodes virtuelles qui doivent etre implementees dans les classes derivees, leur 
nom est prefixe par pub (pour « publique »). 

Les methodes pubimbue et locale permettent respectivement de fixer la locale utilisee par le pro- 
gramme pour ce tampon et de recuperer la locale courante. Par defaut, la locale globale active au 
moment de la construction du tampon est utilisee. Les notions de locales seront decrites dans le Cha- 
pitre 16. 

Les methodes pubsetbuf, pubseekof f et pubseekpos permettent quant a elles de parametrer le 
tampon d'entree / sortie. Ces methodes se contentent d'appeler les methodes virtuelles setbuf, see- 
kof f et seekpos, dont le comportement, specifique a chaque classe derivee, sera decrit ci-dessous. 

Viennent ensuite les methodes d'acces aux donnees en lecture et en ecriture. Les methodes de lecture 
sont respectivement les methodes sgetc, sbumpc et snextc. La methode sgetc permet de lire la 
valeur du caractere reference par le pointeur courant du tampon d'entree. Cette fonction renvoie la 
meme valeur a chaque appel, car elle ne modifie pas la valeur de ce pointeur. En revanche, la methode 
sbumpc fait avancer ce pointeur apres la lecture du caractere courant, ce qui fait qu'elle peut etre 
utilisee pour lire tous les caracteres du flux de donnees physiques. Enfin, la methode snextc appelle 
la methode sbumpc dans un premier temps, puis renvoie la valeur retournee par sgetc. Cette methode 
permet done de lire la valeur du caractere suivant dans le tampon et de positionner le pointeur sur ce 
caractere. Notez que, contrairement a la methode sbumpc, snextc modifie la valeur du pointeur avant 
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de lire le caractere courant, ce qui fait qu'en realite elle lit le caractere suivant. Toutes ces methodes 
renvoient la valeur de fin de fichier definie dans la classe des traits du type de caractere utilise en cas 
d'erreur. Elles sont egalement susceptibles de demander la lecture de donnees complementaires dans 
le cadre de la gestion du tampon. 

La methode in_avail renvoie le nombre de caracteres encore stockes dans le tampon gere par la 
classe basic_streambuf. Si ce tampon est vide, elle renvoie une estimation du nombre de caracteres 
qui peuvent etre lus dans la sequence controlee par le tampon. Cette estimation est un minimum, la 
valeur renvoyee garantit qu'autant d'appel a sbumpc reussiront. 

Les tampons de la bibliotheque standard donnent la possibilite aux programmes qui les utilisent 
d'annuler la lecture d'un caractere. Normalement, ce genre d'annulation ne peut etre effectue qu'une 
seule fois et la valeur qui doit etre replacee dans le tampon doit etre exactement celle qui avait ete 
lue. Les methodes qui permettent d'effectuer ce type d'operation sont les methodes sputbackc et 
sungetc. La premiere methode prend en parametre la valeur du caractere qui doit etre replace dans 
le tampon et la deuxieme ne fait que decrementer le pointeur referencant l'element courant dans le 
tampon de lecture. Ces deux operations peuvent echouer si la valeur a replacer n'est pas egale a la 
valeur du caractere qui se trouve dans le tampon ou si, tout simplement, il est impossible de revenir 
en arriere (par exemple parce qu'on se trouve en debut de sequence). Dans ce cas, ces methodes ren- 
voient la valeur de fin de fichier definie dans la classe des traits du type de caractere utilise, a savoir 
traits : : eof ( ) . 

Enfin, les methodes d'ecriture de la classe basic_streambuf sont les methodes sputc et sputn. La 
premiere permet d'ecrire un caractere unique dans le tampon de la sequence de sortie et la deuxieme 
d'ecrire toute une serie de caracteres. Dans ce dernier cas, les caracteres a ecrire sont specifies a l'aide 
d'un tableau dont la longueur est passee en deuxieme parametre a sputn. Ces deux methodes peuvent 
renvoyer le caractere de fin de fichier de la classe des traits du type de caractere utilise pour signaler 
une erreur d'ecriture. 

L interface protegee de la classe basic_streambuf est constitute des accesseurs aux pointeurs sur les 
tampons d'entree et de sortie d'une part et, d'autre part, des methodes virtuelles que les classes deri- 
vees doivent redefinir pour implementer la gestion des entrees / sorties physiques. 

Les pointeurs du tableau contenant les donnees du tampon de lecture peuvent etre recuperes par les 
classes derivees a l'aide des methodes eback, gptr et egptr. La methode eback renvoie le pointeur 
sur le debut du tableau du tampon d'entree. Les methodes gptr et egptr renvoient quant a elles le 
pointeur sur l'element courant, dont la valeur peut etre obtenue avec la methode sgetc, et le pointeur 
sur la fin du tableau du tampon. Le nom de la methode gptr provient de l'abreviation de 1' anglais 
« get pointer » et celui de la methode egptr de l'abreviation « end of gptr ». Enfin, les methodes 
gbump et setg permettent respectivement de faire avancer le pointeur sur l'element courant d'un 
certain nombre de positions et de fixer les trois pointeurs du tampon de lecture en une seule operation. 

Les pointeurs du tampon d'ecriture sont accessibles par des methodes similaires a celles definies 
pour le tampon de lecture. Ainsi, les methodes pbase, pptr et epptr permettent respectivement 
d'acceder au debut du tableau contenant les donnees du tampon d'ecriture, a la position courante 
pour les ecritures et au pointeur de fin de ce tableau. « pptr » est ici l'abreviation de l'anglais « put 
pointer ». Les methodes pbump et setp jouent le meme role pour les pointeurs du tampon d'ecriture 
que les methodes gbump et setg pour les pointeurs du tampon de lecture. 

Enfin, les methodes protegees de la classe basic_streambuf permettent, comme on l'a deja indique 
ci-dessus, de communiquer avec les classes derivees implementant les entrees / sorties physiques. Le 
role de ces methodes est decrit dans le tableau ci-dessous : 



Methode Description 



283 



Chapitre 15. Les flux d' entree / sortie 



Methode 


Description 


imbue 


Cette methode est appelee a chaque fois qu'il y a un changement de locale au 
niveau du tampon. Les classes derivees de la classe basic_streambuf sont 
assurees qu'il n'y aura pas de changement de locale entre chaque appel a cette 
fonction et peuvent done maintenir une reference sur la locale courante en 
permanence. Les notions concernant les locales seront decrites dans le Chapitre 
16. 


setbuf 


Cette methode n'est appelee que par la methode pubsetbuf . Elle a 
principalement pour but de fixer la zone memoire utilisee par le tampon. Ceci 
peut ne pas avoir de sens pour certains medias, aussi cette methode peut-elle ne 
rien faire du tout. En pratique, si cette fonction est appellee avec deux 
parametres nuls, les mecanismes de gestion du cache doivent etre desactives. 
Pour cela, la classe derivee doit fixer les pointeurs des tampons de lecture et 
d'ecriture a la valeur nulle. 


seekof f 


Cette methode n'est appelee que par la methode pubseekof f . Tout comme la 
methode setbuf, sa semantique est specifique a chaque classe derivee de 
gestion des medias physiques. En general, cette fonction permet de deplacer la 
position courante dans la sequence de donnees d'un certain decalage. Ce 
decalage peut etre specifie relativement a la position courante, au debut ou a la 
fin de la sequence de donnees sous controle. Le mode de deplacement est 
specifie a l'aide du parametre sens, qui doit prendre l'une des constantes de 
type seekdir definie dans la classe ios_base. De meme, le tampon concerne par 
ce deplacement est specifie par le parametre mode, dont la valeur doit etre l'une 
des constante de type ios_base::openmode. Ces types et ces constantes seront 
decrits avec la classe de base ios_base dans la Section 15.3. 


seekpos 


Cette methode n'est appelee que par la methode pubseekpos. Elle fonctionne 
de maniere similaire a la methode seekof f puisqu'elle permet de positionner 
le pointeur courant des tampons de la classe basic_streambuf a un emplacement 
arbitraire dans la sequence de donnees sous controle. 


sync 


Cette methode n'est appelee que par la methode pubsync et permet de 
demander la synchronisation du tampon avec la sequence de donnees 
physiques. Autrement dit, les operations d'ecritures doivent etre effectuees sur 
le champ afin de s' assurer que les modifiations effectuees dans le cache soient 
bien enregistrees. 


showmanyc 


Cette methode est appelee par la methode in_avail lorsque la fin du tampon 
de lecture a ete atteinte. Elle doit renvoyer une estimation basse du nombre de 
caracteres qui peuvent encore etre lus dans la sequence sous controle. Cette 
estimation doit etre sure, dans le sens ou le nombre de caracteres renvoyes doit 
effectivement pouvoir etre lu sans erreur. 


xsgetn 


Cette methode n'est appelee que par la methode sgetn. Elle permet d'effectuer 
la lecture de plusieurs caracteres et de les stocker dans le tableau recu en 
parametre. La lecture de chaque caractere doit se faire exactement comme si la 
methode sbumpc etait appelee successivement pour chacun d'eux afin de 
maintenir le tampon de lecture dans un etat coherent. La valeur retournee est le 
nombre de caracteres effectivement lus ou traits : : eof ( ) en cas d'erreur. 
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Methode 


Description 


underflow 


Cette methode est appelee lorsque la fin du tampon est atteinte lors de la 
lecture d'un caractere. Cela peut se produire lorsqu'il n'y a plus de caractere 
disponible dans le tampon ou tout simplement a chaque lecture, lorsque le 
mecanisme de cache est desactive. Cette fonction doit renvoyer le caractere 
suivant de la sequence sous controle et remplir le tampon si necessaire. Le 
pointeur referencant le caractere courant est alors initialise sur le caractere dont 
la valeur a ete recuperee. Ainsi, la methode underflow doit remplir le tampon, 
mais ne doit pas faire avancer la position courante de lecture. Cette methode 
peut renvoyer traits : : eof ( ) en cas d'echec, ce qui se produit generalement 
lorsque la fin de la sequence sous controle a ete atteinte. 


uf low 


Cette methode est appelee dans les memes conditions que la methode 
underflow. Elle doit egalement remplir le tampon, mais, contrairement a 
underflow, elle fait egalement avancer le pointeur du caractere courant d'une 
position. Ceci implique que cette methode ne peut pas etre utilisee avec les flux 
non bufferises. En general, cette methode n'a pas a etre redefinie parce que le 
code de la methode uf low de la classe basic_streambuf effectue ces operations 
en s'appuyant sur la methode underflow. Cette methode peut renvoyer 
traits :: eof () en cas d'echec. 


pbackf ail 


Cette methode est appelee lorsque la methode sputbackc echoue, soit parce 
que le pointeur de lecture se trouve au debut du tampon de lecture, soit parce 
que le caractere qui doit etre replace dans la sequence n'est pas le caractere qui 
vient d'en etre extrait. Cette methode doit prendre en charge le deplacement des 
caracteres du tampon pour permettre le replacement du caractere fourni en 
parametre et mettre a jour les pointeurs de gestion du tampon de lecture en 
consequence. Elle peut renvoyer la valeur traits : : eof ( ) pour signaler un 
echec. 


xsputn 


Cette methode n'est appelee que par la methode sputn. Elle permet de realiser 
l'ecriture de plusieurs caracteres dans la sequence de sortie. Ces caracteres sont 
specifies dans le tableau fourni en parametre. Ces ecritures sont realisees 
exactement comme si la methode sputc etait appelee successivement pour 
chaque caractere afin de maintenir le tampon d'ecriture dans un etat coherent. 
La valeur retournee est le nombre de caracteres ecrits ou traits : : eof ( ) en 
cas d'erreur. 


overflow 


Cette methode est appelee par les methodes d'ecriture de la classe 
basic_streambuf lorsque le tampon d'ecriture est plein. Elle a pour but de 
degager de la place dans ce tampon en consommant une partie des caracteres 
situes entre le pointeur de debut du tampon et le pointeur de position d'ecriture 
courante. Elle est done susceptible d'effectuer les ecritures physiques sur le 
media de sortie au cours de cette operation. Si l'ecriture reussit, les pointeurs de 
gestion du tampon d'ecriture doivent etre mis a jour en consequence. Dans le 
cas contraire, la fonction peut renvoyer la valeur traits : : eof ( ) pour signaler 
Perreur ou lancer une exception. 



15.2.3. Les classes de tampons basic_streambuf et basic_filebuf 

Vous l'aurez compris, l'ecriture d'une classe derivee de la classe basic_streambuf prenant en charge 
un media peut etre relativement technique et difficile. Heureusement, cette situation ne se presente 
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quasiment jamais, parce que la bibliotheque standard C++ fournit des classes derivees prenant en 
charge les deux situations les plus importantes : les tampons d'acces a une chaine de caracteres et les 
tampons d'acces aux fichiers. Ces classes sont respectivement les classes template basic_stringbuf 
et basic_filebuf. 

15.2.3.1. La classe basic_stringbuf 

La classe basic_stringbuf permet d'effectuer des entrees / sorties en memoire de la meme maniere 
que si elles etaient effectuees sur un peripherique d' entree / sortie normal. Le but de cette classe 
n'est evidemment pas d'optimiser les performances a l'aide d'un cache puisque les operations se font 
a destination de la memoire, mais d'uniformiser et de permettre les memes operations de formatage 
dans des chaines de caracteres que celles que Ton peut realiser avec les flux d' entree / sortie normaux. 

La classe basic_streambuf derive bien entendu de la classe basic_streambuf puisqu'elle definit les 
operations fondamentales d'ecriture et de lecture dans une chaine de caracteres. Elle est declaree 
comme suit dans l'en-tete s stream : 

template <class charT, 

class traits = char_traits<charT>, 

class Allocator = allocator<chatT> > 
class basic_stringbuf : public basic_streambuf <charT, traits> 
{ 

public : 
// Les types : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

typedef traits traits_type; 

// Les constructeurs / destructeurs : 

explicit basic_stringbuf ( 

ios_base : : openmode mode = ios_base::in | ios_base : : out ) ; 

explicit basic_stringbuf ( 

const basic_string<charT, traits, Allocator> Sstr, 
ios_base :: openmode mode = ios_base::in | ios_base : : out ) ; 

virtual ~basic_stringbuf ( ) ; 

// Les methodes de gestion de la chaine de caracteres sous controle : 
basic_string<charT, traits, Allocator> str() const; 
void str (const basic_string<charT, traits, Allocator> &s); 

}; 



Comme cette declaration le montre, la classe basic_streambuf definit elle aussi un jeu de types permet- 
tant d'obtenir facilement les types de objets manipules. De plus, elle definit egalement quelques me- 
thodes complementaires permettant d'effectuer les operations specifiques aux flux orientes chaine de 
caracteres. En particulier, les constructeurs permettent de fournir une chaine de caracteres a partir de 
laquelle le tampon sera initialise. Cette chaine de caracteres est copiee lors de la construction du tam- 
pon, ce qui fait qu'elle peut etre reutilisee ou modifiee apres la creation du tampon. Ces constructeurs 
prennent egalement en parametre le mode de fonctionnement du tampon. Ce mode peut etre la lecture 
(auquel cas le parametre mode vaut ios_base : : in), l'ecriture (mode vaut alors ios_base : : out) 
ou les deux (mode vaut alors la combinaison de ces deux constantes par un ou logique). Les constantes 
de mode d'ouverture sont definis dans la classe ios_base, que Ton decrira dans la Section 15.3. 
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Note : Vous remarquerez que, contrairement au constructeur de la classe basic_streambuf, les 
constructeurs de la classe basic_stringbuf sont declares dans la zone de declaration publique, 
ce qui autorise la creation de tampons de type basic_stringbuf. Le constructeur de la classe de 
base est appele par ces constructeurs, qui ont le droit de le faire puisqu'il s'agit d'une methode 

protected. 



II est egalement possible d'acceder aux donnees stockees dans le tampon a l'aide des accesseurs str. 
Le premier renvoie une basic_string contenant la chaine du tampon en ecriture si possible (c'est-a-dire 
si le tampon a ete cree dans le mode ecriture ou lecture / ecriture), et la chaine du tampon en lecture 
sinon. Le deuxieme accesseur permet de definir les donnees du tampon a posteriori, une fois celui-ci 
cree. 

Exemple 15-1. Lecture et ecriture dans un tampon de chaine de caracteres 

linclude <iostream> 
linclude <string> 
linclude <sstream> 

using namespace stcl; 

int main (void) 
{ 

// Construit une chaine de caractere : 

string s ("123456789") ; 

// Construit un tampon base sur cette chaine : 

stringbuf sb(s); 

// Lit quelques caracteres unitairement : 

cout << (char) sb . sbumpc ( ) << endl; 

cout << (char) sb . sbumpc ( ) << endl; 

cout << (char) sb . sbumpc ( ) << endl; 

// Replace le dernier caractere lu dans le tampon : 

sb . sungetc ( ) ; 

// Lit trois caracteres consecutivement : 

char tab[4] ; 

sb . sgetn (tab, 3) ; 

tab [3] = 0; 

cout << tab << endl; 

// Ecrase le premier caractere de la chaine : 

sb . sputc ( ' a' ) ; 

// Recupere une copie de la chaine utilisee par le tampon 

cout << sb.strO << endl; 

return 0; 



Note : La classe basic_stringbuf redefinit bien entendu certaines des methodes protegees de la 
classe basic_streambuf. Ces methodes n'ont pas ete presentees dans la declaration ci-dessus 
parce qu'elles font partie de ('implementation de la classe basic_stringbuf et leur description n'a 
que peu d'interet pour les utilisateurs. 
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15.2.3.2. La classe basic f ilebuf 

La classe basic_filebuf est la classe qui prend en charge les operations d'entree / sortie sur fichier dans 
la bibliotheque standard C++. 

Pour la bibliotheque standard C++, un fichier est une sequence de caracteres simples (done de type 
char). II est important de bien comprendre qu'il n'est pas possible, avec la classe basic_filebuf, de 
manipuler des fichiers contenant des donnees de type wchar_t. En effet, meme dans le cas ou les 
donnees enregistrees sont de type wchar_t, les fichiers contenant ces donnees sont enregistres sous la 
forme de sequences de caracteres dont 1' unite de base reste le caractere simple. La maniere de coder 
les caracteres larges dans les fichiers n'est pas specifiee et chaque implementation est libre de faire 
ce qu'elle veut a ce niveau. Generalement, l'encodage utilise est un encodage a taille variable, e'est a 
dire que chaque caractere large est represente sous la forme d'un ou de plusieurs caracteres simples, 
selon sa valeur et selon sa position dans le flux de donnees du fichier. 

Cela signifie qu'il ne faut pas faire d'hypothese sur la maniere dont les instances de la classe tem- 
plate basic_filebuf enregistrent les donnees des fichiers pour des valeurs du parametre template 
charT autres que le type char. En general, l'encodage utilise ne concerne pas le programmeur, puis- 
qu'il suffit d'enregistrer et de lire les fichiers avec les meme types de classes basic_filebuf pour re- 
trouver les donnees initiales. Toutefois, si les fichiers doivent etre relus par des programmes ecrits 
dans un autre langage ou compiles avec un autre compilateur, il peut etre necessaire de connaitre 
l'encodage utilise. Vous trouverez cette information dans la documentation de votre environnement 
de developpement. 

La classe basic_filebuf est declaree comme suit dans l'en-tete f stream : 

template <class charT, 

class traits = char_traits<charT> > 
class basic_f ilebuf : public basic_streambuf <charT, traits> 
{ 

public : 
// Les types : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

typedef traits traits_type; 

// Les constructeurs / destructeurs : 
basic_f ilebuf ( ) ; 
virtual ~basic_f ilebuf () ; 

// Les methodes de gestion du fichier sous controle : 
basic_f ilebuf <charT, traits> *open (const char *s, 

ios_base : : openmode mode); 
basic_f ilebuf <charT, traits> *close () ; 
bool is_open() const; 



Comme vous pouvez le constater, la classe basic_filebuf est semblable a la classe basic_stringbuf. 
Outre les declarations de types et celles du constructeur et du destructeur, elle definit trois methodes 
permettant de realiser les operations specifiques aux fichiers. 

La methode open permet, comme son nom 1'indique, d'ouvrir un fichier. Cette methode prend en pa- 
rametre le nom du fichier a ouvrir ainsi que le mode d'ouverture. Ce mode peut etre une combinaison 
logique de plusieurs constantes definies dans la classe ios_base. Ces constantes sont decrites dans la 
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Section 15.3. Les plus importantes sont in, qui permet d'ouvrir un fichier en lecture, out, qui permet 
de l'ouvrir en lecture, binary, qui permet de l'ouvrir en mode binaire, app, qui permet de l'ouvrir 
en mode ajout, et trunc, qui permet de le vider lorsqu'il est ouvert en ecriture. La methode open 
renvoie le pointeur this si le fichier a pu etre ouvert ou le pointeur nul dans le cas contraire. 

La classe basic_filebuf ne gere qu'une seule position pour la lecture et l'ecriture dans les fichiers. 
Autrement dit, si un fichier est ouvert a la fois en lecture et en ecriture, les pointeurs de lecture et 
d' ecriture du tampon auront toujours la meme valeur. L'ecriture a une position provoquera done non 
seulement la modification de la position courante en ecriture, mais egalement celle de la position 
courante en lecture. 

La methode close est la methode a utiliser pour fermer un fichier ouvert. Cette methode ne peut 
fonctionner que si un fichier est effectivement ouvert dans ce tampon. Elle renvoie le pointeur this 
si le fichier courant a effectivement pu etre ferme ou le pointeur nul en cas d'erreur. 

Enfin, la methode is_open permet de determiner si un fichier est ouvert ou non dans ce tampon. 

Exemple 15-2. Lecture et ecriture dans un tampon de fichier 

#include <iostream> 
tinclude <string> 
#include <fstream> 

using namespace std; 

int main (void) 
{ 

// Ouvre un fichier texte et cree un tampon pour y acceder : 

filebuf fb; 

fb . open ( "test . txt" , ios_base::in | ios_base : : out I ios_base :: trunc) ; 

// Teste si le fichier est ouvert : 

if (fb . is_open ( ) ) 

{ 

// Ecrit deux lignes : 

string 11 = "Bon jour\n" ; 

string 12 = "tout le monde !\n"; 

fb . sputn (11 . data ( ) , 11. sized); 

fb . sputn (12 . data ( ) , 12.size()); 

// Repositionne le pointeur de fichier au debut. 

// Note : le deplacement se fait pour les deux 

// tampons parce qu' il n' y a qu'un pointeur 

// sur les donnees du fichier : 

fb .pubseekpos (0, ios_base::in | ios_base : : out ) ; 

// Lit les premieres lettres du fichier : 

cout << (char) fb.sbumpcO << endl; 

cout << (char) fb.sbumpcO << endl; 

cout << (char) fb.sbumpcO << endl; 

// Ferme le fichier : 

fb . close ( ) ; 
} 
return 0; 



289 



Chapitre 15. Les flux d' entree / sortie 

15.3. Les classes de base des flux : ios_base et basic_ios 

Les classes de gestion des flux constituent la deuxieme hierarchie de classes de la bibliotheque stan- 
dard d' entree / sortie. Bien que destinees a acceder a des medias varies, ces classes disposent d'une 
interface commune qui permet d'en simplifier l'utilisation. Cette interface est essentiellement definie 
par deux classes de bases fondamentales : la classe ios_base, qui definit toutes les fonctionnalites 
independantes du type de caractere utilise par les flux, et la classe template basic_ios, qui regroupe 
l'essentiel des fonctionnalites des flux d'entree / sortie. 

15.3.1. La classe ios_base 

La classe ios_base est une classe C++ classique dont toutes les classes template de gestion des 
flux d'entree / sortie derivent. Cette classe ne fournit, comme c'est le cas de la plupart des classes 
de base, qu'un nombre de fonctionnalites tres reduit. En pratique, sa principale utilite est de definir 
plusieurs jeux de constantes qui sont utilisees par ses classes derivees pour identifier les options des 
differents modes de fonctionnement disponibles. Ces constantes portent un nom standardise mais leur 
type n'est pas precise par la norme C++. Cependant, leur nature (entiere, enumeration, champ de bits) 
est imposee, et les implementations doivent definir un typedef permettant de creer des variables du 
meme type. 

La classe de base ios_base est declaree comme suit dans l'en-tete ios : 

class ios_base 

{ 

// Constructeur et destructeur : 

protected: 

ios_base ( ) ; 
public : 

~ios_base ( ) ; 

// Classe de base des exceptions des flux d'entree / sortie : 
class failure; 

// Classe d' initialisation des objets d'entree / sortie standards : 
class Init; 

// Constantes de definition des options de formatage : 
typedef Tl fmtflags; 
static const fmtflags boolalpha; 
static const fmtflags hex; 
static const fmtflags oct; 
static const fmtflags dec; 
static const fmtflags fixed; 
static const fmtflags scientific; 
static const fmtflags left; 
static const fmtflags right; 
static const fmtflags internal; 
static const fmtflags showbase; 
static const fmtflags showpoint; 
static const fmtflags showpos; 
static const fmtflags uppercase; 
static const fmtflags unitbuf; 
static const fmtflags skipws; 
static const fmtflags adjustf ield; 
static const fmtflags basefield; 
static const fmtflags floatfield; 



290 



Chapitre 15. Les flux d' entree / sortie 



II Constantes des modes d'ouverture des flux et des fichiers : 
typedef T3 openmode; 
static const openmode in; 
static const openmode out; 
static const openmode binary; 
static const openmode trunc; 
static const openmode app; 
static const openmode ate; 

// Constantes de definition des modes de positionnement : 
typedef T4 seekdir; 
static const seekdir beg; 
static const seekdir cur; 
static const seekdir end; 

// Constantes d'etat des flux d' entree / sortie : 
typedef T2 iostate; 
static const iostate goodbit; 
static const iostate eofbit; 
static const iostate failbit; 
static const iostate badbit; 

// Accesseurs sur les options de formatage : 
fmtflags flags () const; 
fmtflags flags (fmtflags fmtfl); 
fmtflags setf (fmtflags fmtfl); 
fmtflags setf (fmtflags fmtfl, fmtflags mask); 
void unsetf ( fmtflags mask); 
streamsize precision () const; 
streamsize precision (streamsize prec) ; 
streamsize width () const; 
streamsize width (streamsize wide); 

// Methode de synchronisation : 

static bool sync_with_stdio (bool sync = true); 

// Methode d' enregistrement des callback pour les evenements : 
enum event { erase_event, imbue_event, copyfmt_event }; 
typedef void (*event_callback) (event, ios_base &, int index) 
void register_callback (event_call_back fn, int index) ; 

// Methode de gestion des donnees privees : 
static int xalloc(); 
long &iword(int index); 
void* &pword(int index); 

// Methodes de gestion des locales : 
locale imbue (const locale Sloe) ; 
locale getlocO const; 



Comme vous pouvez le constater, le constructeur de la classe ios_base est declare en zone protegee. 
II n'est done pas possible d'instancier un objet de cette classe, ce qui est normal puisqu'elle n'est 
destinee qu'a etre la classe de base de classes plus specialisees. 
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Le premier jeu de constantes defini par la classe ios_base contient toutes les valeurs de type fmtflags, 
qui permettent de specifier les differentes options a utiliser pour le formatage des donnees ecrites dans 
les flux. Ce type doit obligatoirement etre un champ de bits. Les constantes quant a elles permettent 
de definir la base de numerotation utilisee, si celle-ci doit etre indiquee avec chaque nombre ou non, 
ainsi que les differentes options de formatage a utiliser. La signification precise de chacune de ces 
constantes est donnee dans le tableau suivant : 

Tableau 15-1. Options de formatage des flux 



Constante 


Signification 


boolalpha 


Permet de realiser les entrees / sorties des booleens sous forme textuelle et non 
sous forme numerique. Ainsi, les valeurs true et false ne sont pas ecrites ou 
lues sous la forme de ou de 1, mais sous la forme fixee par la classe de 
localisation utilisee par le flux. Par defaut, les booleens sont represented par les 
chaines de caracteres « true » et « false » lorsque ce flag est actif. Cependant, il 
est possible de modifier ces chaines de caracteres en definissant une locale 
specifique. Les notions de locales seront decrites dans le Chapitre 16. 


hex 


Permet de realiser les entrees / sorties des entiers en base hexadecimale. 


oct 


Permet de realiser les entrees / sorties des entiers en base octale. 


dec 


Permet de realiser les entrees / sorties des entiers en decimal. 


fixed 


Active la representation en virgule fixe des nombres a virgule flottante. 


scientific 


Active la representation en virgule flottante des nombres a virgule flottante. 


left 


Utilise l'alignement a gauche pour les donnees ecrites sur les flux de sortie. 
Dans le cas ou la largeur des champs est fixee, des caracteres de remplissage 
sont ajoutes a la droite de ces donnees pour atteindre cette largeur. 


right 


Utilise l'alignement a droite pour les donnees ecrites sur les flux de sortie. 
Dans le cas ou la largeur des champs est fixee, des caracteres de remplissage 
sont ajoutes a la gauche de ces donnees pour atteindre cette largeur. 


internal 


Effectue un remplissage avec les caracteres de remplissage a une position fixe 
determinee par la locale en cours d' utilisation si la largeur des donnees est 
inferieure a la largeur des champs a utiliser. Si la position de remplissage n'est 
pas specifiee par la locale pour l'operation en cours, le comportement adopte est 
l'alignement a droite. 


showbase 


Precise la base utilisee pour le formatage des nombres entiers. 


showpoint 


Ecrit systematiquement le separateur de la virgule dans le formatage des 
nombres a virgule flottante, que la partie fractionnaire de ces nombres soit nulle 
ou non. Le caractere utilise pour representer ce separateur est defini dans la 
locale utilisee par le flux d'entree / sortie. La notion de locale sera vue dans le 
Chapitre 16. Par defaut, le caractere utilise est le point decimal (' . '). 


showpos 


Utilise systematiquement le signe des nombres ecrits sur le flux de sortie, 
qu'ils soient positifs ou negatifs. Le formatage du signe des nombre se fait 
selon les criteres definis par la locale active pour ce flux. Par defaut, les 
nombres negatifs sont prefixes du symbole '-' et les nombres positifs du 
symbole '+' si cette option est active. Dans le cas contraire, le signe des 
nombres positifs n'est pas ecrit. 


uppercase 


Permet d'ecrire en majuscule certains caracteres, comme le 'e' de l'exposant 
des nombres a virgule flottante par exemple, ou les chiffres hexadecimaux A a 

F. 
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Constante 


Signification 


unitbuf 


Permet d'effectuer automatiquement une operation de synchronisation du 
cache utilise par le flux de sortie apres chaque ecriture. 


skipws 


Permet d'ignorer les blancs precedant les donnees a lire dans les operations 
d'entree pour lesquelles de tels blancs sont significatifs. 



La classe ios_base definit egalement les constantes adjustf ield, basef ield et f loatf ield, qui 
sont en realite des combinaisons des autres constantes. Ainsi, la constante adjustf ield represente 
l'ensemble des options d'alignement (a savoir left, right et internal), la constante basef ield 
represente les options de specification de base pour les sorties numeriques (c'est-a-dire les options 
hex, oct et dec), et la constante f loatf ield les options definissant les types de formatage des 
nombres a virgules (scientific et fixed). 

Le deuxieme jeu de constantes permet de caracteriser les modes d'ouverture des flux et des fichiers. 
Le type de ces constantes est le type openmode. II s'agit egalement d'un champ de bits, ce qui permet 
de realiser des combinaisons entre leurs valeurs pour cumuler differents modes d'ouverture lors de 
1' utilisation des fichiers. Les constantes definies par la classe ios_base sont decrites dans le tableau 
ci-dessous : 

Tableau 15-2. Modes d'ouverture des fichiers 



Constante 


Signification 


in 


Permet d'ouvrir le flux en ecriture. 


out 


Permet d'ouvrir le flux en lecture. 


binary 


Permet d'ouvrir le flux en mode binaire, pour les systemes qui font une 
distinction entre les fichiers textes et les fichiers binaires. Ce flag n'est pas 
necessaire pour les systemes d'exploitation conformes a la norme POSIX. 
Cependant, il est preferable de l'utiliser lors de l'ouverture de fichiers binaires 
si Ton veut que le programme soit portable sur les autres systemes 
d'exploitation. 


trunc 


Permet de vider automatiquement le fichier lorsqu'une ouverture en ecriture est 
demandee. 


app 


Permet d'ouvrir le fichier en mode ajout lorsqu'une ouverture en ecriture est 
demandee. Dans ce mode, le pointeur de fichier est systematiquement 
positionne en fin de fichier avant chaque ecriture. Ainsi, les ecritures se font les 
unes a la suite des autres, toujours a la fin du fichier, et quelles que soient les 
operations qui peuvent avoir lieu sur le fichier entre-temps. 


ate 


Permet d'ouvrir le fichier en ecriture et de positionner le pointeur de fichier a la 
fin de celui-ci. Notez que ce mode de fonctionnement se distingue du mode app 
par le fait que si un repositionnement a lieu entre deux ecritures la deuxieme 
ecriture ne se fera pas forcement a la fin du fichier. 



Le troisieme jeu de constantes definit les diverses directions qu'il est possible d'utiliser lors d'un 
repositionnement d'un pointeur de fichier. Le type de ces constantes, a savoir le type seekdir, est une 
enumeration dont les valeurs sont decrites dans le tableau ci-dessous : 

Tableau 15-3. Directions de deplacement dans un fichier 
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Constante 


Signification 


beg 


Le emplacement de fait par rapport au debut du fichier. Le decalage specifie 
dans les fonctions de repositionnement doit etre positif ou nul, la valeur 
correspondant au debut du fichier. 


cur 


Le deplacement se fait relativement a la position courante. Le decalage specifie 
dans les fonctions de repositionnement peut done etre negatif, positif ou nul 
(auquel cas aucun deplacement n'est effectue). 


end 


Le deplacement se fait relativement a la fin du fichier. Le decalage fourni dans 
les fonctions de repositionnement doit etre positif ou nul, la valeur 
correspondant a la fin de fichier. 



Enfin, les constantes de type iostate permettent de decrire les differents etats dans lequel un flux 
d' entree / sortie peut se trouver. II s'agit, encore une fois, d'un champ de bits, et plusieurs combinai- 
sons sont possibles. 



Tableau 15-4. Etats des flux d'entree / sortie 



Constante 



Signification 



goodbit 



Cette constante correspond a l'etat normal du flux, lorsqu'il ne s'est produit 
aucune erreur. 



eofbit 



Ce bit est positionne dans la variable d'etat du flux lorsque la fin du flux a ete 
atteinte, soit parce qu'il n'y a plus de donnees a lire, soit parce qu'on ne peut 
plus en ecrire. 



failbit 



Ce bit est positionne dans la variable d'etat du flux lorsqu'une erreur logique 
s'est produite lors d'une operation de lecture ou d'ecriture. Ceci peut avoir lieu 
lorsque les donnees ecrites ou lues sont incorrectes. 



badbit 



Ce bit est positionne lorsqu'une erreur fatale s'est produite. Ce genre de 
situation peut se produire lorsqu'une erreur a eu lieu au niveau materiel (secteur 
defectueux d'un disque dur ou coupure reseau par exemple). 



Les differentes variables d'etat des flux d'entree / sortie peuvent etre manipulees a l'aide de ces 
constantes et des accesseurs de la classe ios_base. Les methodes les plus importantes sont sans doute 
celles qui permettent de modifier les options de formatage pour le flux d'entree / sortie. La methode 
flags permet de recuperer la valeur de la variable d'etat contenant les options de formatage du flux. 
Cette methode dispose egalement d'une surcharge qui permet de specifier une nouvelle valeur pour 
cette variable d'etat, et qui retourne la valeur precedente. II est aussi possible de fixer et de desactiver 
les options de formatage independamment les unes des autres a l'aide des methodes setf et unsetf . 
La methode setf prend en parametre les nouvelles options qui doivent etre ajoutees au jeu d'options 
deja actives, avec, eventuellement, un masque permettant de reinitialiser certaines autres options. On 
emploiera generalement un masque lorsque Ton voudra fixer un parametre parmi plusieurs parametres 
mutuellement exclusifs, comme la base de numerotation utilisee par exemple. La methode unsetf 
prend quant a elle le masque des options qui doivent etre supprimees du jeu d'options utilise par le 
flux en parametre. 

Outre les methodes de gestion des options de formatage, la classe ios_base definit deux surcharges 
pour chacune des methodes precision et width. Ces methodes permettent respectivement de lire 
et de fixer la precision avec laquelle les nombres a virgule doivent etre ecrits et la largeur minimale 
des conversions des nombres lors des ecritures. 
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La plupart des options que Ton peut fixer sont permanentes, c'est-a-dire qu'elles restent actives jus- 
qu'a ce qu'on specifie de nouvelles options. Cependant, ce n'est pas le cas du parametre de largeur 
que Ton renseigne grace a la methode width. En effet, chaque operation d'ecriture reinitialise ce 
parametre a la valeur 0. II faut done specifier la largeur minimale pour chaque donnee ecrite sur le 
flux. 

Exemple 15-3. Modification des options de formatage des flux 

#include <iostream> 
using namespace std; 

// Affiche un booleen, un nombre entier et un nombre a virgule : 

void print (bool b, int i, float f) 

{ 

cout << b << " " << i << " " << f << endl; 



int main (void) 
{ 

// Affiche avec les options par defaut : 

print (true, 35, 31053 67.9751447); 

// Passe en hexadecimal : 

cout .unset f (ios_base : : dec) ; 

cout . setf (ios_base : : hex) ; 

print (true, 35, 31053 67.9751447); 

// Affiche la base des nombres et 

// affiche les booleens textuellement : 

cout. setf (ios_base : : bool alpha) ; 

cout . setf (ios_base : : showbase) ; 

print (true, 35, 31053 67.9751447); 

// Affiche un flottant en notation a virgule fixe 

// avec une largeur minimale de 16 caracteres : 

cout << "***"; 

cout .width (16) ; 

cout . setf (ios_base : : fixed, ios_base : : f loatf ield) ; 

cout << 315367.9751447; 

cout << "***" << endl; 

// Recommence en fixant la precision 

// a 3 chiffres et la largeur a 10 caracteres : 

cout << "***"; 

cout.precision(3) ; 

cout . width ( 10 ) ; 

cout << 315367.9751447; 

cout << "***" << endl; 

return 0; 



Note : On prendra bien garde au fait que la largeur des champs dans lesquels les donnees sont 
ecrites est une largeur minimale, pas une largeur maximale. En particulier, cela signigie que les 
ecritures ne sont pas tronquees si elles sont plus grande que cette largeur. On devra done faire 
extremement attention a ne pas provoquer de debordements lors des ecritures. 

On n'oubliera pas de s'assurer de la coherence des parametres du flux lorsqu'on modifie la valeur 
d'une option. Par exemple, dans I'exemple precedent, il faut desactiver I'emploi de la numerota- 
tion decimale lorsque Ton demande a utiliser la base hexadecimale. Cette operation a ete faite 
explicitement ici pour bien montrer son importance, mais elle aurait egalement pu etre realisee 
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par I'emploi d'un masque avec la constante ios_base: :basefieid. L'exemple precedent mon- 
tre comment utiliser un masque avec I'appel a setf pour fixer la representation des nombres a 
virgule. 



La classe ios_base fournit egalement un certain nombre de services generaux au programmeur et a 
ses classes derivees. La methode sync_with_stdio permet de determiner, pour un flux d'entree / 
sortie standard, s'il est synchronise avec le flux sous-jacent ou si des donnees se trouvent encore dans 
son tampon. Lorsqu'elle est appelee avec le parametre false des le debut du programme, elle permet 
de decorreler le fonctionnement du flux C++ et du flux standard sous-jacent. Pour tous les autres ap- 
pels, cette methode ignore le parametre qui lui est fourni. La methode register_callback permet 
d'enregistrer une fonction de rappel qui sera appelee par la classe ios_base lorsque des evenements 
susceptibles de modifier notablement le comportement du flux se produisent. Ces fonctions de rappel 
peuvent recevoir une valeur entiere en parametre qui peut etre utilisee pour referencer des donnees 
privees contenant des parametres plus complexes. Les methodes xalloc, iword et pword sont four- 
nies afin de permettre de stocker ces donnees privees et de les retrouver facilement a l'aide d'un 
indice, qui peut etre la valeur passee en parametre a la fonction de rappel. Ces methodes permettent 
de recuperer des references sur des valeurs de type long et sur des pointeurs de type void. Enfin, la 
classe ios_base fournit une classe de base pour les exceptions que les classes de flux pourront utiliser 
afin de signaler une erreur et une classe permettant d'initialiser les objets cin, cout, cerr, clog et 
leurs semblables pour les caracteres larges. Toutes ces fonctionnalites ne sont generalement pas d'une 
tres grande utilite pour les programmeurs et sont en realite fournie pour faciliter 1' implementation des 
classes de flux de la bibliotheque standard. 

Enfin, la classe ios_base fournit les methodes getloc et imbue qui permettent respectivement de 
recuperer la locale utilisee par le flux et d'en fixer une autre. Cette locale est utilisee par le flux 
pour determiner la maniere de representer et de lire les nombres et pour effectuer les entrees / sorties 
formatees en fonction des parametres de langue et des conventions locales du pays ou le programme 
est execute. Les notions de locale et de parametres internationaux seront decrits en detail dans le 
Chapitre 16. 



15.3.2. La classe basic_ios 

La classe template basic_ios fournit toutes les fonctionnalites communes a toutes les classes de 
flux de la bibliotheque d'entree / sortie. Cette classe derive de la classe ios_base et apporte tous les 
mecanismes de gestion des tampons pour les classes de flux. La classe basic_ios est declaree comme 
suit dans l'en-tete ios : 

template <class charT, 

class traits = char_traits<charT> > 
class basic_ios : public ios_base 
{ 

// Constructeur et destructeur : 
protected: 

basic_ios ( ) ; 

void init (basic_streambuf <charT, traits> *flux); 

public : 

// Types de donnees : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 
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typedef traits traits_type; 

// Constructeur publique, destructeur et operation de copie : 
explicit basic_ios (basic_streambuf <charT, traits> *flux) ; 
virtual ~basic_ios ( ) ; 
basic_ios Scopyfmt (const basic_ios &); 

// Methodes de gestion des tampons : 

basic_streambuf <charT, traits> *rdbuf () const; 
basic_streambuf <charT, traits> *rdbuf ( 

basic_streambuf <charT, traits> *tampon) ; 

// Methodes de gestion des exceptions : 
iostate exceptions () const; 
void exceptions (iostate except) ; 

// Accesseurs : 

operator void*() const 

bool operator! () const 

iostate rdstateO const; 

void clear (iostate statut = goodbit); 

void setstate (iostate statut) ; 

bool good ( ) const; 

bool eof() const; 

bool fail() const; 

bool bad ( ) const; 

char_type fill() const; 

char_type f ill (char_type c) ; 

basic_ostream<charT, traits> *tie() const; 

basic_ostream<charT, traits> *tie ( 

basic_ostream<charT, traits> *flux) ; 

// Methodes de gestion des locales : 
locale imbue (const locale Sloe) ; 
char narrow (char_type c, char defaut) const; 
char_type widen (char c) const; 



Le constructeur de base ainsi que la methode init, destinee a associer un tampon a un flux apres sa 
construction, sont declares en zone protegee. Ainsi, il n'est pas possible d'instancier et d' initialiser 
manuellement un flux avec un tampon. Cependant, la classe basic_ios fournit un constructeur en zone 
publique qui permet de creer un nouveau flux et de l'initialiser a la volee. Ce constructeur prend 
en parametre l'adresse d'un tampon qui sera associe au flux apres la construction. Remarquez que, 
bien qu'il soit ainsi parfaitement possible d'instancier un objet de type l'une des instances de la 
classe template basic_ios, cela n'a pas grand interet. En effet, cette classe ne fournit pas assez de 
fonctionnalites pour realiser des entrees / sorties facilement sur le flux. La classe basic_ios est done 
reellement destinee a etre utilisee en tant que classe de base pour des classes plus specialisees dans 
les operations d' entree / sortie. 

Une fois initialises, les flux sont associes aux tampons grace auxquels ils accedent aux medias phy- 
siques pour leurs operations d'entree / sortie. Cependant, cette association n'est pas figee et il est 
possible de changer de tampon a posteriori. Les manipulations de tampon sont effectuees avec les 
deux surcharges de la methode rdbuf . La premiere permet de recuperer l'adresse de l'objet tampon 
courant et la deuxieme d'en specifier un nouveau. Cette derniere methode renvoie l'adresse du tampon 
precedent. Bien entendu, le fait de changer le tampon d'un flux provoque sa reinitialisation. 
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Les flux de la bibliotheque standard peuvent signaler les cas d'erreurs aux fonctions qui les utilisent de 
differentes manieres. La premiere est simplement de renvoyer un code d'erreur (false ou le caractere 
de fin de fichier), et la deuxieme est de lancer une exception derivee de la classe d' exception failure 
(definie dans la classe de base ios_base). Ce comportement est parametrable en fonction des types 
d'erreurs qui peuvent se produire. Par defaut, les classes de flux n'utilisent pas les exceptions, quelles 
que soient les erreurs rencontrees. Toutefois, il est possible d'activer le mecanisme des exceptions 
individuellement pour chaque type d'erreur possible. La classe basic_ios gere pour cela un masque 
d' exceptions qui peut etre recupere et modifie a l'aide de deux methodes surchargees. Ces methodes 
sont les methodes except ions. La premiere version renvoie le masque courant et la deuxieme permet 
de fixer un nouveau masque. Les masques d' exceptions sont constitues de combinaisons logiques des 
bits d'etat des flux definis dans la classe ios_base (a savoir goodbit, eof bit, f ailbit et badbit). 
Le fait de changer le masque d'exceptions reinitialise l'etat du flux. 

La classe basic_ios fournit egalement tout un ensemble d'accesseurs grace auxquels il est possible de 
recuperer l'etat courant du flux. Ces accesseurs sont principalement destines a faciliter la manipulation 
du flux et a simplifier les differentes expressions dans lesquelles il est utilise. Par exemple, l'operateur 
de transtypage vers le type pointeur sur void permet de tester la validite du flux comme s'il s'agissait 
d'un pointeur. Cet operateur retourne en effet une valeur non nulle si le flux est utilisable (c'est-a-dire 
si la methode fail renvoie false. De meme, l'operateur de negation operator ! renvoie la meme 
valeur que la methode fail. 

Comme vous l'aurez sans doute compris, la methode fail indique si le flux (et done le tampon 
controle par ce flux) est dans un etat correct. En pratique, cette methode renvoie true des que l'un 
des bits ios_base : : f ailbit ou ios_base : : badbit est positionne dans la variable d'etat du flux. 
Vous pourrez faire la distinction entre ces deux bits grace a la methode bad, qui elle ne renvoie true 
que si le bit ios_base: :badbit est positionne. Les autres methodes de lecture de l'etat du flux 
portent des noms explicites et leur signification ne doit pas poser de probleme. On prendra toutefois 
garde a bien distinguer la methode clear, qui permet de reinitialiser l'etat du flux avec le masque de 
bits passe en parametre, de la methode setstate, qui permet de positionner un bit complementaire. 
Ces deux methodes sont susceptibles de lancer des exceptions si le nouvel etat du flux le requiert et si 
son masque d'exceptions l'exige. 

Le dernier accesseur utile pour le programmeur est 1'accesseur fill. Cet accesseur permet de lire 
la valeur du caractere de remplissage utilise lorsque la largeur des champs est superieure a la largeur 
des donnees qui doivent etre ecrites sur le flux de sortie. Par defaut, ce caractere est le caractere 
d'espacement. 

Note : Les deux surcharges de la methode tie permettent de stocker dans le flux un pointeur sur 
un flux de sortie standard avec lequel les operations d'entree / sortie doivent etre synchronisers. 
Ces methodes sont utilisees en interne par les methodes d'entree / sortie des classes derivees 
de la classe basic_ios et ne sont pas reellement utiles pour les programmeurs. En general done, 
seule les classes de la bibliotheque standard les appelleront. 



Enfin, la classe basic_ios prend egalement en compte la locale du flux dans tous ses traitements. Elle 
redefinit done la methode imbue afin de pouvoir detecter les changement de locale que l'utilisateur 
peut faire. Bien entendu, la methode getloc est heritee de la classe de base ios_base et permet tou- 
jours de recuperer la locale courante. De plus, la classe basic_ios definit deux methodes permettant 
de realiser les conversions entre le type de caractere char et le type de caractere fourni en parametre 
template. La methode widen permet, comme son nom l'indique, de convertir un caractere de type 
char en un caractere du type template du flux. Inversement, la methode narrow permet de conver- 
tir un caractere du type de caractere du flux en un caractere de type char. Cette methode prend en 
parametre le caractere a convertir et la valeur par defaut que doit prendre le resultat en cas d'echec de 
la conversion. 
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15.4. Les flux d'entree / sortie 

La plupart des fonctionnalites des flux d'entree / sortie sont implementees au niveau des classes 
template basic_ostream et basic_istream. Ces classes derivent toutes deux directement de la classe 
basic_ios, dont elles heritent de toutes les fonctionnalites de gestion des tampons et de gestion d'etat. 

Les classes basic_ostream et basic_istream seront sans doute les classes de flux que vous utiliserez le 
plus souvent, car c'est a leur niveau que sont definies toutes les fonctionnalites de lecture et d'ecriture 
sur les flux, aussi bien pour les donnees formatees telles que les entiers, les flottants ou les chaines de 
caracteres, que pour les ecritures de donnees brutes. De plus, les flux d'entree / sortie standards cin, 
cout, cerr et clog sont tous des instances de ces classes. 

La bibliotheque standard definit egalement une classe capable de realiser a la fois les operations de 
lecture et d'ecriture sur les flux : la classe basic_iostream. En fait, cette classe derive simplement des 
deux classes basic_istream et basic_ostream, et regroupe done toutes les fonctionnalites de ces deux 
classes. 

15.4.1. La classe de base basic_ostream 

La classe basic_ostream fournit toutes les fonctions permettant d'effectuer des ecritures sur un flux 
de sortie, que ces ecritures soient formatees ou non. Elle est declaree comme suit dans 1'en-tete 

ostream : 

template <class charT, 

class traits = char_traits<charT> > 
class basic_ostream : virtual public basic_ios<charT, traits> 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

typedef traits traits_type; 

// Le constructeur et le destructeur : 

explicit basic_ostream (basic_streambuf <char_type, traits> *tampon) ; 
virtual ~basic_ostream ( ) ; 

// Les operations d' ecritures formatees : 

basic_ostream<charT, traits> &operator<< (bool) ; 

basic_ostream<charT, traits> &operator<< (short ) ; 

basic_ostream<charT, traits> Soperator<< (unsigned short); 

basic_ostream<charT, traits> &operator<< (int ) ; 

basic_ostream<charT, traits> &operator<< (unsigned int); 

basic_ostream<charT, traits> &operator<< (long) ; 

basic_ostream<charT, traits> Soperator« (unsigned long) ; 

basic_ostream<charT, traits> &operator<< (float ) ; 

basic_ostream<charT, traits> &operator<< (double) ; 

basic_ostream<charT, traits> &operator<< (long double); 

basic_ostream<charT, traits> Soperator« (void *); 

basic_ostream<charT, traits> Soperator<< 

(basic_streambuf <char_type, traits> *tampon) ; 

// Classe de gestion des exceptions pour les operateurs d' ecritures formatees 
class sentry 
{ 
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public : 

explicit sentry (basic_ostream<charT, traits> &); 

-sentry ( ) ; 

operator bool(); 
}; 

// Les operations d'ecritures non formatees : 

basic_ostream<charT, traits> &put (char_type) ; 

basic_ostream<charT, traits> Swrite (const char_type *p, streamsize taille) ; 

// Les operations cle gestion du tampon : 

basic_ostream<charT, traits> & flush (); 

pos_type tellpO; 

basic_ostream<charT, traits> Sseekp (pos_type) ; 

basic_ostream<charT, traits> Sseekp (of f_type, ios_base : : seekdir) ; 

// Les operations de gestion des manipulateurs : 
basic_ostream<charT, traits> &operator<< 

(basic_ostream<charT, traits> & (*pf) ( 
basic_ostream<charT, traits> &)); 
basic_ostream<charT, traits> &operator<< 

(basic_ios<charT, traits> & (*pf) (basic_ios<charT, traits> &)); 
basic_ostream<charT, traits> Soperator<< 
(ios_base & (*pf) (ios_base &)); 
}; 



Comme vous pouvez le constater, le constructeur de cette classe prend en parametre un pointeur 
sur l'objet tampon dans lequel les ecritures devront etre realisees. Vous pouvez done construire un 
flux de sortie a partir de n'importe quel tampon, simplement en fournissant ce tampon en parametre 
au constructeur. Cependant, il ne faut pas proceder ainsi en general, mais utiliser plutot les classes 
derivees de la classe basic_ostream et specialisees dans les ecritures sur fichiers et dans des chaines 
de caracteres. 

Les ecritures formatees sont realisees par F intermediate de differentes surcharges de l'operateur 
d'insertion operator<<, dont il existe une version pour chaque type de donnee de base du langage. 
Ainsi, l'ecriture d'une valeur dans le flux de sortie se fait extremement simplement : 

// Ecriture d'une chaine de caracteres sur le flux de sortie standard : 
cout << "Voici la valeur d' un entier :\n"; 

// Ecriture d'un entier sur le flux de sortie standard : 
cout << 4 5; 

Vous constaterez que, grace aux mecanismes de surcharge, ces ecritures se font exactement de la 
meme maniere pour tous les types de donnees. On ne peut faire plus simple... 

Note : Les operations de formatage prennent en compte toutes les options de formatage qui sont 
stockees dans la classe de base ios_base. En general, les operations d'ecriture ne modifient pas 
ces options. Toutefois, la largeur minimale des champs dans lesquels les resultats sont formates 
est systematiquement reinitialises a apres chaque ecriture. II est done necessaire, lorsque Ton 
realise plusieurs ecritures formatees dans un flux de sortie, de specifier pour chaque valeur sa 
largeur minimale si elle ne doit pas etre egale a 0. Autrement dit, il faut redire la largeur de chaque 
champ, meme s'ils utilisent tous la meme largeur minimale. 
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Les operations de formatage utilisent egalement les conventions locales du pays ou le programme 
est execute, conventions qui sont definies dans la locale incluse dans le flux de sortie. Les notions 
de locale seront detaillees dans le Chapitre 16. 



Bien entendu, il est possible de definir de nouvelles surcharges de l'operateur d' insertion pour les 
types dermis par l'utilisateur, ce qui permet d'etendre a l'infini les possibilites de cette classe. Ces 
surcharges devront obligatoirement etre definies a l'exterieur de la classe template basic_ostream 
et, si Ton veut les ecrire de maniere generique, elles devront egalement etre des fonctions template 
parametrees par le type de caractere du flux sur lequel elles travaillent. 

Vous noterez la presence d'une classe sentry dans la classe basic_ostream. Cette classe est une classe 
utilitaire permettant de realiser les initialisations qui doivent preceder toutes les operations d'ecriture 
au sein des surcharges de l'operateur d' insertion. Entre autres operations, le constructeur de cette 
classe peut synchroniser le flux de sortie standard encapsule dans le flux grace a la methode tie 
de la classe de base basic_ios, et prendre toutes les mesures devant preceder les ecritures sur le 
flux. Vous devrez done toujours utiliser un objet local de ce type lorsque vous ecrirez une surcharge 
de l'operateur operator<< pour vos propres types. Les ecritures ne devront etre realisees que si 
l'initialisation a reussi, ce qui peut etre verifie simplement en comparant 1'objet local de type sentry 
avec la valeur true. 

Exemple 15-4. Definition d'un nouvel operateur d'insertion pour un flux de sortie 

#include <iostream> 
#include <string> 

using namespace std; 

// Definition d'un type de donnee prive : 

struct Personne 

{ 

string Norn; 

string Prenom; 

int Age; // En centimetres. 

int Taille; 

}; 

// Definition de l'operateur d'ecriture pour ce type : 
template <class charT, class Traits> 
basic_ostream<charT, Traits> &operator<< ( 

basic_ostream<charT, Traits> Sflux, 

const Personne &p) 



{ 



// Inialisation du flux de sortie : 

typename basic_ostream<charT, Traits> :: sentry init(flux) 

if (init) 

{ 

// Ecriture des donnees : 
int Metres = p. Taille / 100; 
int Reste = p. Taille % 100; 
flux << p. Prenom << " " << p. Norn << 
" mesure " << Metres << 
"m" << Reste << " (" << 
p. Age << " an"; 
if (p. Age > 1) flux << "s"; 
flux << ") "; 
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return flux; 



int main (void) 
{ 

// Construit une nouvelle personne : 

Personne p; 

p. Norn = "Dupont"; 

p.Prenom = "Jean"; 

p. Age = 2 8; 

p.Taille = 185; 

// Affiche les caracteristiques de cette personne 

cout << p << endl; 

return 0; 
} 



Note : L'utilisation de I'objet local de type sentry comme un booleen est autorisee parce que la 
classe sentry definit un operateur de transtypage vers le type bool. 

Le constructeur de la classe sentry est susceptible de lancer des exceptions, selon la configura- 
tion du masque d'exceptions du flux de sortie avec lequel on I'initialise. 



Les ecritures de donnees brutes ne disposent bien entendu pas de surcharges pour chaque type de 
donnee, puisqu'il s'agit dans ce cas d'ecrire les donnees directement sur le flux de sortie, sans les for- 
mater sous forme textuelle. Ces ecritures sont done realisees par 1' intermediate de methodes dediees 
qui effectuent soit l'ecriture d'un caractere unique, soit l'ecriture d'un tableau de caracteres com- 
plet. Pour ecrire un unique caractere sur le flux de sortie, vous pouvez utiliser la methode put. Pour 
l'ecriture d'un bloc de donnees en revanche, il faut utiliser la methode write, qui prend en parametre 
un pointeur sur la zone de donnees a ecrire et la taille de cette zone. 

Exemple 15-5. Ecriture de donnees brutes sur un flux de sortie 

#include <iostream> 
using namespace std; 

// Definition de quelques codes de couleurs 
// pour les terminaux ANSI : 

const char Rouge [] = {033, ' [' , '3', ' 1' , 'm'}; 
const char Vert [] = {033, '[', '3', ' 2' , 'm'}," 
const char Jaune [] = {033, '[', '3', '3', 'm'}; 
const char Reset[] = {033, '[', 'm', 017}; 

int main (void) 
{ 

// Ecriture d'un message colore : 

cout. write (Rouge, sizeof (Rouge) ) ; 

cout << "Bon jour "; 

cout .write (Vert, sizeof (Vert )) ; 

cout << "tout "; 

cout. write (Jaune, sizeof (Jaune) ) ; 

cout << "le monde ! " << endl; 

cout. write (Reset, sizeof (Reset) ) ; 

return 0; 
} 
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Bien entendu, la classe basic_ostream fournit les methodes necessaires a la gestion du tampon sous- 
jacent. La methode flush permet de synchroniser le tampon utilise par le flux (en appelant la methode 
pubsync de ce dernier). La methode tellp permet de lire la position courante dans le flux de sortie, 
et les deux surcharges de la methode seekp permettent de modifier cette position soit de maniere 
absolue, soit de maniere relative a la position courante. Nous verrons un exemple d' utilisation de ces 
methodes dans la description des classes de flux pour les fichiers. 

La classe basic_ostream definit egalement des surcharges de l'operateur d' insertion capables de 
prendre en parametre des pointeurs de fonctions. Ces methodes ne constituent pas des operations 
d'ecriture a proprement parler, mais permettent de realiser des operations sur les flux de sortie plus 
facilement a l'aide de fonctions capables de les manipuler. En raison de cette propriete, ces fonctions 
sont couramment appelees des manipulateurs . En realite, ces manipulateurs ne sont rien d' autre que 
des fonctions prenant un flux en parametre et realisant des operations sur ce flux. Les operateurs 
operator« prenant en parametre ces manipulateurs les executent sur l'objet courant *this. 
Ainsi, il est possible d'appliquer ces manipulateurs a un flux simplement en realisant une ecriture du 
manipulateur sur ce flux, exactement comme pour les ecritures normales. 

La bibliotheque standard definit tout un jeu de manipulateurs extremement utiles pour definir les 
options de formatage et pour effectuer des operations de base sur les flux. Grace a ces manipulateurs, 
il n'est plus necessaire d'utiliser la methode setf de la classe ios_base par exemple. Par exemple, le 
symbole endl utilise pour effectuer un retour a la ligne dans les operations d'ecriture sur les flux de 
sortie n'est rien d'autre qu'un manipulateur, dont la declaration est la suivante : 

template <class charT, class Traits> 
basic_ostream<charT, Traits> Sendl ( 

basic_ostream<charT, Traits> &f lux) ; 

et dont le role est simplement d'ecrire le caractere de retour a la ligne et d'appeler la methode flush 
du flux de sortie. 

II existe des manipulateurs permettant de travailler sur la classe de base ios_base ou sur ses classes 
derivees comme la classe basic_ostream par exemple, d'ou la presence de plusieurs surcharges de 
l'operateur d'insertion pour ces differents manipulateurs. II existe egalement des manipulateurs pre- 
nant des parametres et renvoyant un type de donnees special pour lequel un operateur d'ecriture a ete 
defini, et qui permettent de realiser des operations plus complexes necessitant des parametres com- 
plementaires. Les manipulateurs sont definis, selon leur nature, soit dans l'en-tete de declaration du 
flux, soit dans l'en-tete ios, soit dans l'en-tete iomanip. 

Le tableau suivant presente les manipulateurs les plus simples qui ne prennent pas de parametre : 
Tableau 15-5. Manipulateurs des flux de sortie 



Manipulateur 


Fonction 


endl 


Envoie un caractere de retour a la ligne sur le flux et synchronise le tampon par 
un appel a la methode flush. 


ends 


Envoie un caractere nul terminal de fin de ligne sur le flux. 


flush 


Synchronise le tampon utilise par le flux par un appelle a la methode flush. 


boolalpha 


Active le formatage des booleens sous forme textuelle. 


noboolalpha 


Desactive le formatage textuel des booleens. 


hex 


Formate les nombres en base 16. 


oct 


Formate les nombres en base 8. 


dec 


Formate les nombres en base 10. 


fixed 


Utilise la notation en virgule fixe pour les nombres a virgule. 
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Manipulateur 



Fonction 



scientific 



Utilise la notation en virgule flottante pour les nombres a virgule. 



left 



Aligne les resultats a gauche. 



right 



Aligne les resultats a droite. 



internal Utilise le remplissage des champs avec des espaces complementaires a une 

position fixe determinee par la locale courante. Equivalent a right si la locale 
ne specifie aucune position de remplissage particuliere. 



showbase 



Indique la base de numerotation utilisee. 



noshowbase 



N' indique pas la base de numerotation utilisee. 



showpoint Utilise le separateur de virgule dans les nombres a virgule, meme si la partie 

fractionnaire est nulle. 



noshowpoint N'utilise le separateur de virgule que si la partie fractionnaire des nombres a 

virgule flottante est significative. 



showpos 



Ecrit systematiquement le signe des nombres, meme s'ils sont positifs. 



noshowpos 



N'ecrit le signe des nombres que s'ils sont negatifs. 



uppercase 



Ecrit les exposants et les chiffres hexadecimaux en majuscule. 



nouppercase 



Ecrit les exposants et les chiffres hexadecimaux en minuscule. 



unitbuf 



Effectue une operation de synchronisation du cache gere par le tampon du flux 
apres chaque ecriture. 



nounitbuf N'effectue les operations de synchronisation du cache gere par le tampon du 

flux que lorsque cela est explicitement demande. 



Les parametres suivants sont un peu plus complexes, puisqu'ils prennent des parametres complemen- 
taires. lis renvoient un type de donnee specifique a chaque implementation de la bibliotheque standard 
et qui n'est destine qu'a etre insere dans un flux de sortie a l'aide de l'operateur d'insertion : 

Tableau 15-6. Manipulateurs utilisant des parametres 



Manipulateur 


Fonction 


resetiosflags (ios_base : : fmt flags) 


Permet d'effacer certains bits des options du 
flux. Ces bits sont specifies par une combinaison 
logique de constantes de type ios_base::fmtflags. 


setiosflags (ios_base : : fmt flags) 


Permet de positionner certains bits des options 
du flux. Ces bits sont specifies par une 
combinaison logique de constantes de type 
ios_base::fmtflags. 


setbase(int base) 


Permet de selectionner la base de numerotation 
utilisee. Les valeurs admissibles sont 8, 10 et 16 
respectivement pour la base octale, la base 
decimale et la base hexadecimale. 


setprecision (int) 


Permet de specifier la precision (nombre de 
caracteres significatifs) des nombres formates. 


setw (int) 


Permet de specifier la largeur minimale du 
champ dans lequel la donnee suivante sera ecrite 
a la prochaine operation d'ecriture sur le flux. 
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Manipulateur 


Fonction 


setf ill (char_type) 


Permet de specifier le caractere de remplissage a 
utiliser lorsque la largeur des champs est 
inferieure a la largeur minimale specifiee dans les 
options de formatage. 



Exemple 15-6. Utilisation des manipulateurs sur un flux de sortie 

#include <iostream> 
#include <iomanip> 

using namespace std; 

int main (void) 
{ 

// Affiche les booleens sous forme textuelle : 

cout << boolalpha << true << endl; 

// Ecrit les nombres en hexadecimal : 

cout << hex << 57 << endl; 

// Repasse en base 10 : 

cout << dec << 57 << endl; 

// Affiche un flottant avec une largeur 

// minimale de 15 caracteres : 

cout << setfillC*') << setw(15) << 3.151592 << endl; 

// Recommence mais avec un alignement a gauche : 

cout << left << setw(15) << 3.151592 << endl; 



15.4.2. La classe de base basic_istream 

La deuxieme classe la plus utilisee de la bibliotheque d' entree / sortie est sans doute la classe tem- 
plate basic_istream. A l'instar de la classe ostream, cette classe fournit toutes les fonctionnalites de 
lecture de donnees formatees ou non a partir d'un tampon. Ce sont done certainement les methodes 
cette classe que vous utiliserez le plus souvent lorsque vous desirerez lire les donnees d'un flux. La 
classe basic_istream est declaree comme suit dans l'en-tete i stream : 

template <class charT, 

class traits = char_traits<charT> > 
class basic_istream : virtual public basic_ios<charT, traits> 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

typedef traits traits_type; 

// Le constructeur et destructeur : 

explicit basic_istream (basic_streambuf <charT, traits> *sb) ; 
virtual ~basic_istream ( ) ; 
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II Les operation de gestion des entrees formatees : 

basic_istream<charT, traits> Soperator>> (bool &n) ; 

basic_istream<charT, traits> Soperator>> (short &n) ; 

basic_istream<charT, traits> Soperator>> (unsigned short &n) ; 

basic_istream<charT, traits> Soperator>> (int &n) ; 

basic_istream<charT, traits> &operator>> (unsigned int &n) ; 

basic_istream<charT, traits> Soperator>> (long &n) ; 

basic_istream<charT, traits> &operator>> (unsigned long Sn) ; 

basic_istream<charT, traits> Soperator>> (float &f ) ; 

basic_istream<charT, traits> &operator>> (double &f ) ; 

basic_istream<charT, traits> Soperator>> (long double &f ) ; 

basic_istream<charT, traits> &operator>> (void * &p) ; 

basic_istream<charT, traits> &operator>> 

(basic_streambuf <char_type, traits> *sb) ; 

// Classe de gestion des exceptions pour les operateurs d'ecritures formatees 
class sentry 
{ 
public : 

explicit sentry (basic_istream<charT, traits> Sflux, 

bool conserve = false) ; 
-sentry ( ) ; 
operator bool(); 
}; 

// Les operations de lecture des donnees brutes : 
int_type get ( ) ; 

basic_istream<charT, traits> &get (char_type &c) ; 
int_type peek(); 

basic_istream<charT, traits> Sputback (char_type c) ; 

basic_istream<charT, traits> Sunget () ; 

basic_istream<charT, traits> Sread (char_type *s, streamsize n) ; 
streamsize readsome (char_type *s, streamsize n) ; 

basic_istream<charT, traits> &get (char_type *s, streamsize n) ; 
basic_istream<charT, traits> &get (char_type *s, streamsize n, 

char_type delim) ; 
basic_istream<charT, traits> &get ( 

basic_streambuf <char_type, traits> &sb) ; 
basic_istream<charT, traits> &get ( 

basic_streambuf <char_type, traits> &sb, char_type delim) ; 
basic_istream<charT, traits> Sgetline (char_type *s, streamsize n) ; 
basic_istream<charT, traits> Sgetline (char_type *s, streamsize n, 

char_type delim) ; 
basic_istream<charT, traits> Signore 

(streamsize n = 1, int_type delim = traits :: eof ()) ; 

streamsize gcount ( ) const; 

// Les operations de gestion du tampon : 
int sync ( ) ; 
pos_type tellgO; 

basic_istream<charT, traits> Sseekg (pos_type) ; 
basic_istream<charT, traits> Sseekg (of f_type, ios_base : : seekdir) ; 

// Les operations de gestion des manipulateurs : 
basic_istream<charT, traits> Soperator» 
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(basic_istream<charT, traits> & (*pf) ( 
basic_istream<charT, traits> &)); 
basic_istream<charT, traits> Soperator>> 

(basic_ios<charT, traits> & (*pf) (basic_ios<charT, traits> &)); 
basic_istream<charT, traits> Soperator>> 
(ios_base & (*pf) (ios_base &)); 
}; 



Tout comme la classe basic_ostream, le constructeur de la classe basic_istream prend en parametre 
un pointeur sur l'objet gerant le tampon dans lequel les ecritures devront etre effectuees. Cependant, 
meme s'il est possible de creer une instance de flux d'entree simplement a 1'aide de ce constructeur, 
cela n'est pas recommande puisque la bibliotheque standard fournit des classes specialisees permet- 
tant de creer des flux de sortie orientes fichiers ou chaines de caracteres. 

L'utilisation des differentes surcharges de l'operateur d'extraction des donnees formatees 
operator>> ne devrait pas poser de probleme. Le compilateur determine la surcharge a utiliser en 
fonction du type des donnees a lire, determine par la reference de variable fournie en parametre. 
Cette surcharge recupere alors les informations dans le tampon associe au flux, les interprete et ecrit 
la nouvelle valeur dans la variable. 

Bien entendu, tout comme pour la classe basic_ostream, il est possible d'ecrire de nouvelles sur- 
charges de l'operateur d'extraction afin de prendre en charge de nouveaux types de donnees. Ideale- 
ment, ces surcharges devront etre egalement des fonctions template parametrees par le type de ca- 
ractere du flux sur lequel elles travaillent, et elles devront egalement utiliser une classe d'initialisation 
sentry. Cette classe a principalement pour but d' initialiser le flux d'entree, eventuellement en le syn- 
chronisant avec un flux de sortie standard dont la classe basic_ostream peut etre stockee dans le flux 
d'entree a l'aide de la methode tie de la classe de base basic_ios, et en supprimant les eventuels 
caracteres blancs avant la lecture des donnees. 

Notez que, contrairement a la classe sentry des flux de sortie, le constructeur de la classe sentry des 
flux d'entree prend un deuxieme parametre. Ce parametre est un booleen qui indique si les caracteres 
blancs presents dans le flux de donnees doivent etre elimines avant 1' operation de lecture ou non. En 
general, pour les operations de lecture formatees, ce sont des caracteres non significatifs et il faut 
effecivement supprimer ces caracteres, aussi la valeur a specifier pour ce second parametre est-elle 
false. Comme c'est aussi la valeur par defaut, la maniere d' utiliser de la classe sentry dans les 
operateurs d'extraction est strictement identique a celle de la classe sentry des operateurs d'insertion 
de la classe basic_ostream. 

Exemple 15-7. Ecriture d'un nouvel operateur d'extraction pour un flux d'entree 

#include <iostream> 
#include <string> 

using namespace std; 

// Definition d'un type de donnee prive : 

struct Personne 

{ 

string Norn; 

string Prenom; 

int Age; // En centimetres. 

int Taille; 

}; 
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II Definition de l'operateur de lecture pour ce type : 
template <class charT, class Traits> 
basic_istream<charT, Traits> &operator>> ( 

basic_istream<charT, Traits> Sflux, Personne &p) 



{ 



// Inialisation du flux de sortie : 

typename basic_istream<charT, Traits> :: sentry init(flux) 

if (init) 

{ 

// Lecture du prenom et du nom : 

flux >> p. Prenom; 

flux >> p.Nom; 

// Lecture de l'age : 

flux >> p.Age; 

// Lecture de la taille en metres : 

double Taille; 

flux >> Taille; 

// Conversion en centimetres ; 

p. Taille = (int) (Taille * 100 + 0.5); 
} 
return flux; 



} 



int main (void) 
{ 

// Construit une nouvelle personne : 

Personne p; 

// Demande la saisie d' une personne : 

cout << "Prenom Nom Age(ans) Taille (m) : "; 

cin >> p; 

// Affiche les valeurs lues : 

cout << endl; 

cout << "Valeurs saisies :" << endl; 

cout << p. Prenom << " " << p.Nom << " a " << 
p.Age << " ans et mesure " << 
p. Taille << " cm." << endl; 

return 0; 
} 



Note : La classe sentry est egalement utilisee par les methodes de lecture de donnees non 
formatees. Pour ces methodes, les caracteres blancs sont importants et dans ce cas le second 
parametre fourni au constructeur de la classe sentry est true. 

Comme pour la classe sentry de la classe basic_ostream, I'utilisation de I'objet d'initialisation 
dans les tests est rendue possible par la presence de l'operateur de transtypage vers le type 
bool. La valeur retournee est true si I'initialisation s'est bien faite et false dans le cas contraire. 
Remarquez egalement que le constructeur de la classe sentry est susceptible de lancer des 
exceptions selon la configuration du masque d'exceptions dans la classe de flux. 



Les operations de lecture de donnees non formatees sont un peu plus nombreuses pour les flux d' entree 
que les operations d'ecriture non formatees pour les flux de sortie. En effet, la classe basic_istream 
donne non seulement la possibilite de lire un caractere simple ou une serie de caracteres, mais aussi de 
lire les donnees provenant du tampon de lecture et de les interpreter en tant que « lignes ». Une ligne 
est en realite une serie de caracteres terminee par un caractere special que Ton nomme le marqueur 
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defin de ligne. En general, ce marqueur est le caractere ' \n', mais il est possible de specifier un autre 
caractere. 

La lecture d'un caractere unique dans le flux d' entree se fait a l'aide de la methode get. II existe deux 
surcharges de cette methode, la premiere ne prenant aucun parametre et renvoyant le caractere lu, et 
la deuxieme prenant en parametre une reference sur la variable devant recevoir le caractere lu et ne 
renvoyant rien. Ces deux methodes extraient les caracteres qu'elles lisent du tampon d'entree que le 
flux utilise. Si Ton veut simplement lire la valeur du caractere suivant sans Ten extraire, il faut appeler 
la methode peek. De plus, tout caractere extrait peut etre reinsere dans le flux d'entree (pourvu que le 
tampon sous-jacent accepte cette operation) a l'aide de l'une des deux methodes unget ou putback. 
Cette derniere methode prend en parametre le caractere qui doit etre reinsere dans le flux d'entree. 
Notez que la reinsertion ne peut etre realisee que si le caractere fourni en parametre est precisement 
le dernier caractere extrait. 

Si Ton desire realiser la lecture d'une serie de caracteres au lieu de les extraire un a un, il faut utiliser 
la methode read. Cette methode est la methode de base pour les lectures non formatees puisqu'elle lit 
les donnees brutes de fonderie, sans les interpreter. Elle prend en parametre un pointeur sur un tableau 
de caracteres dans lequel les donnees seront ecrites et le nombre de caracteres a lire. Cette methode 
ne verifie pas la taille du tableau specifie, aussi celui-ci doit-il etre capable d'accueillir le nombre de 
caracteres demande. II existe une variante de la methode read, la methode readsome, qui permet de 
lire les donnees presentes dans le tampon gere par le flux sans acceder au media que ce dernier prend 
en charge. Cette methode prend egalement en parametre un pointeur sur la zone memoire devant 
recevoir les donnees et le nombre de caracteres desire, mais, contrairement a la methode read, elle 
peut ne pas lire exactement ce nombre. En effet, la methode readsome s'arrete des que le tampon 
utilise par le flux est vide, ce qui permet d'eviter les acces sur le peripherique auquel ce tampon donne 
acces. La methode readsome renvoie le nombre de caracteres effectivement lus. 

Les methodes de lecture des lignes sont a diviser en deux categories. La premiere categorie, constitute 
de plusieurs surcharges de la methode get, permet d'effectuer une lecture des donnees du tampon 
jusqu'a ce que le tableau fourni en parametre soit rempli ou qu'une fin de ligne soit atteinte. La 
deuxieme categorie de methodes est constitute des surcharges de la methode getline. Ces methodes 
se distinguent des methodes get par le fait qu'elles n'echouent pas lorsque la ligne lue (delimiteur de 
ligne compris) remplit completement le tableau fourni en parametre d'une part, et par le fait que le 
delimiteur de ligne est extrait du tampon d'entree utilise par le flux d'autre part. Autrement dit, si une 
ligne complete (c'est-a-dire avec son delimiteur) a une taille exactement egale a la taille du tableau 
fourni en parametre, les methodes get echoueront alors que les methodes getline reussiront, car 
elles ne considerent pas le delimiteur comme une information importante. Ceci revient a dire que les 
methodes getline interpreted completement le caractere delimiteur, alors que les methodes get le 
traitent simplement comme le caractere auquel la lecture doit s'arreter. 

Dans tous les cas, un caractere nul terminal est insere en lieu et place du delimiteur dans le tableau 
fourni en parametre et devant recevoir les donnees. Comme le deuxieme parametre de ces methodes 
indique la dimension de ce tableau, le nombre de caracteres lu est au plus cette dimension moins un. 
Le nombre de caracteres ex traits du tampon d'entree est quant a lui recuperable grace a la methode 
gcount. Remarquez que le caractere de fin de ligne est compte dans le nombre de caracteres extraits 
pour les methodes getline, alors qu'il ne Test pas pour les methodes get puisque ces dernieres ne 
1' extraient pas du tampon. 

Enfin, il est possible de demander la lecture d'un certain nombre de caracteres et de les passer sans 
en recuperer la valeur. Cette operation est realisable a l'aide de la methode ignore, qui ne prend 
done pas de pointeurs sur la zone memoire ou les caracteres lus doivent etre stockes puisqu'ils sont 
ignores. Cette methode lit autant de caracteres que specifie, sauf si le caractere delimiteur indique en 
deuxieme parametre est rencontre. Dans ce cas, ce caractere est extrait du tampon d'entree, ce qui fait 
que la methode ignore se comporte exactement comme les methodes getline. 
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Exemple 15-8. Lectures de lignes sur le flux d'entree standard 

#include <iostream> 
#include <sstream> 

using namespace std; 

int main (void) 
{ 

// Tableau devant recevoir une ligne : 

char petit_tableau [10] ; 

// Lit une ligne de 9 caracteres : 

cout << "Saisissez une ligne :" << endl; 

cin . getline (petit_tableau, 10); 

if (cin.failO) 

cout << "Ligne trop longue !" << endl; 

cout << "Lu : ***" << petit_tableau << "***" << endl; 

// Lit une ligne de taille arbitraire via un tampon : 

cout << "Saisissez une autre ligne :" << endl; 

stringbuf s; 

cin . get (s) ; 

// Affiche la ligne lue : 

cout << "Lu : ***" << s.str() << "***"; 

// Extrait le caractere de saut de ligne 

// et ajoute-le au flux de sortie standard : 

cout << (char) cin.getO; 

return 0; 



Note : Remarquez que le caractere de saut de ligne etant lu, il est necessaire de saisir deux 
retours de chariot successifs pour que la methode getiine renvoie son resultat. Comme pour 
toutes les methodes de lectures formatees, ce caractere interrompt la lecture dans le flux d'entree 
standard du programme et se trouve done encore dans le tampon d'entree lors de la lecture 
suivante. Cela explique que dans le cas de lectures successives, il faut extraire ce caractere du 
flux d'entree manuellement, par exemple a I'aide de la methode get. C'est ce que cet exemple 
realise sur sa derniere ligne pour I'envoyer sur le flux de sortie standard. 

De plus, on ne peut pas prevoir, a priori, quelle sera la taille des lignes saisies par I'utilisateur. 
On ne procedera done pas comme indique dans cet exemple pour effectuer la lecture de lignes 
en pratique. II est en effet plus facile d'utiliser la fonction getiine, que Ton a decrit dans la 
Section 14.1 .8 dans le cadre du type basic_string. En effet, cette fonction permet de lire une ligne 
complete sans avoir a se soucier de sa longueur maximale et de stocker le resultat dans une 
basic_string. 



La classe basic_istream dispose egalement de methodes permettant de manipuler le tampon qu'elle 
utilise pour lire de nouvelles donnees. La methode sync permet de synchroniser le tampon d'entree 
avec le media auquel il donne acces, puisqu'elle appelle la methode pub sync de ce tampon. Pour 
les flux d'entree, cela n'a pas reellement d'importance parce que Ton ne peut pas ecrire dedans. La 
methode t e 1 1 g permet de determiner la position du pointeur de lecture courant, et les deux surcharges 
de la methode seekg permettent de repositionner ce pointeur. Nous verrons un exemple d'utilisation 
de ces methodes dans la description des classes de flux pour les fichiers. 

Enfin, les flux d'entree disposent egalement de quelques manipulateurs permettant de les configurer 
simplement a I'aide de l'operateur operator>>. Ces manipulateurs sont presentes dans le tableau 
ci-dessous : 
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Tableau 15-7. Manipulateurs des flux d'entree 



Manipulateur 


Fonction 


boolalpha 


Active 1' interpretation des booleens sous forme de textuelle. 


noboolalpha 


Desactive 1' interpretation des booleens sous forme textuelle. 


hex 


Utilise la base 16 pour 1' interpretation des nombres entiers. 


oct 


Utilise la base 8 pour 1' interpretation des nombres entiers. 


dec 


Utilise la base 10 pour 1' interpretation des nombres entiers. 


skipws 


Ignore les espaces lors des entrees formatees. 


noskipws 


Conserve les espaces lors des entrees formatees. 


ws 


Supprime tous les espaces presents dans le flux d'entree jusqu'au 
premier caractere non blanc. 



Ces manipulateurs s'utilisent directement a l'aide de l'operateur operator>>, exactement comme 
les manipulateurs de la classe basic_ostream s'utilisent avec l'operateur d'insertion normal. 



15.4.3. La classe basic_iostream 

La bibliotheque standard definit dans l'en-tete iostream la classe template basic_iostream afin 
de permettre a la fois les operations d'ecriture et les operations de lecture sur les flux. En fait, cette 
classe n'est rien d' autre qu'une classe derivee des deux classes basic_ostream et basic_istream qui 
fournissent respectivement, comme on l'a vu, toutes les fonctionnalites de lecture et d'ecriture sur un 
tampon. 

La classe basic_iostream ne comporte pas d'autres methodes qu'un constructeur et un destructeur, 
qui servent uniquement a initialiser et a detruire les classes de base basic_ostream et basic_istream. 
L'utilisation de cette classe ne doit done pas poser de probleme particulier et je vous invite a vous 
referer aux descriptions des classes de base si besoin est. 

Note : Tout comme ses classes de base, la classe basic_iostream sera rarement utilisee directe- 
ment. En effet, elle dispose de classes derivees specialisees dans les operations d'ecriture et 
de lecture sur fichiers ou dans des chaines de caracteres, classes que Ton presentera dans les 
sections suivantes. Ce sont ces classes que Ton utilisera en pratique lorsque Ton desirera creer 
un nouveau flux pour lire et ecrire dans un fichier ou dans une basic_string. 

Vous aurez peut-etre remarque que les classes basic_ostream et basic_istream utilisent un 
heritage virtuel pour recuperer les fonctionnalites de la classe de base basic_ios. La raison en 
est que la classe basic_iostream realise un heritage multiple sur ses deux classes de base et 
que les donnees de la classe basic_ios ne doivent etre presente qu'en un seul exemplaire dans 
les flux d'entree / sortie. Cela implique que les constructeurs des classes derivees de la classe 
basic_iostream prenant des parametres doivent appeler explicitement les constructeurs de toutes 
leur classes de base. Voyez la Section 8.6 pour plus de details sur les notions d'heritage multiple 
et de classes virtuelles. 



15.5. Les flux d'entree / sortie sur chaines de caracteres 

Afin de donner la possibilite aux programmeurs d'effectuer les operations de formatage des donnees 
en memoire aussi simplement qu'avec les classes de gestion des flux d'entree / sortie standards, la 
bibliotheque d'entree / sortie definit trois classes de flux capables de travailler dans des chaines de 
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caracteres de type basic_string. Ces classes sont les classes basic_ostringstream, pour les ecritures 
dans les chaines de caracteres, basic_istringstream, pour les lectures de donnees stockees dans les 
chaines de caracteres, et basic_stringstream, pour les operations a la fois d'ecriture et de lecture. 

Ces classes derivent respectivement des classes de flux basic_istream, basic_ostream et 
basic_iostream et reprennent done a leur compte toutes les fonctions de formatage et d'ecriture de 
ces classes. Les ecritures et les lectures de donnees en memoire se font done, grace a ces classes, 
aussi facilement qu'avec les flux d'entree / sortie standards, et ce de maniere completement 
transparente. 

En fait, les classes de flux orientees chaines de caracteres fonctionnent exactement comme leurs 
classes de base, car toutes les fonctionnalites de gestion des chaines de caracteres sont encapsulees au 
niveau des classes de gestion des tampons qui ont ete presentees au debut de ce chapitre. Cependant, 
elles disposent de methodes specifiques qui permettent de manipuler les chaines de caracteres sur 
lesquelles elles travaillent. Par exemple, la classe basic_ostringstream est declaree comme suit dans 
l'en-tete sstream : 

template <class charT, 

class traits = char_traits<charT>, 

class Allocator = allocator<charT> > 
class basic_ostringstream : public basic_ostream<charT, traits> 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

// Les constructeurs et destructeurs : 

explicit basic_ostringstream (ios_base : : openmode mode = ios_base : : out ) ; 
explicit basic_ostringstream ( 

const basic_string<charT, traits, Allocator> Schaine, 
ios_base :: openmode mode = ios_base : : out ) ; 
virtual ~basic_ostringstream ( ) ; 

// Les methodes de gestion de la chaine de caracteres : 

basic_stringbuf <charT, traits, Allocator> *rdbuf () const; 

basic_string<charT, traits, Allocator> str () const; 

void str (const basic_string<charT, traits, Allocator> Schaine); 

}; 

Les classes basic_istringstream et basic_stringstream sont declarees de maniere identique, a ceci pres 
que les classes de base et les valeurs par defaut pour les modes d'ouverture du tampon sur la chaine 
de caracteres ne sont pas les memes. 

Comme vous pouvez le constater, il est possible de construire un flux d'entree / sortie sur une chaine 
de caracteres de differentes manieres. La premiere methode est de construire un objet flux, puis de 
preciser, pour les flux d'entree, la chaine de caracteres dans laquelle les donnees a lire se trouvent a 
l'aide de la methode str. La deuxieme methode est tout simplement de fournir tous les parametres 
en une seule fois au constructeur. En general, les valeurs par defaut specifiees dans les constructeurs 
correspondent a ce que Ton veut faire avec les flux, ce qui fait que la construction de ces flux est 
extremement simple. 

Une fois construit, il est possible de realiser toutes les operations que Ton desire sur le flux. Dans 
le cas des flux d'entree, il est necessaire que le flux ait ete initialise avec une chaine de caracteres 
contenant les donnees a lire, et Ton ne cherche generalement pas a recuperer cette chaine apres usage 
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du flux. Pour les flux de sortie, cette initialisation est inutile. En revanche, le resultat des operations 
de formatage sera generalement recupere a l'aide de la methode str une fois celles-ci realisees. 

Exemple 15-9. Utilisation de flux d'entree / sortie sur chaines de caracteres 

#include <iostream> 
#include <sstream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

// Lit une ligne en entree : 

cout << "Entier Reel Chaine : "; 

string input; 

getline(cin, input); 

// Interprete la ligne lue : 

istringstream is (input); 

int i; 

double d; 

string s; 

is >> i >> d; 

is >> ws; 

getline (is, s) ; 

// Formate la reponse : 

ostringstream os; 

os << "La reponse est : " << endl; 

os << s << " " << 2*i << " " << 2*d << endl; 

// Affiche la chaine de la reponse : 

cout << os . str ( ) ; 

return 0; 
} 

Comme l'exemple precedent vous le montre, l'utilisation des flux d'entree / sortie de la bibliotheque 
standard sur les chaines de caracteres est reellement aisee. Comme ces operations ne peuvent etre 
realisees qu'en memoire, c'est a dire en dehors du contexte du systeme d'exploitation utilise, les 
classes de flux de la bibliotheque restent utiles meme si les operations d'entree / sortie du systeme se 
font de telle maniere que les objets cin et cout ne sont pratiquement pas utilisables. 



15.6. Les flux d'entree / sortie sur fichiers 

Les classes d'entree / sortie sur les fichiers sont implementees de maniere similaire aux classes 
d'entree / sortie sur les chaines de caracteres, a ceci pres que leurs methodes specifiques permettent 
de manipuler un fichier au lieu d'une chaine de caracteres. Ainsi, la classe basic_ofstream derive de 
basic_ostream, la classe basic_ifstream de la classe basic_istream, et la classe basic_fstream de la 
classe basic_iostream. Toutes ces classes sont declarees dans l'en-tete f stream. Vous trouverez a 
titre d'exemple la declaration de la classe basic_ofstream tel qu'il apparait dans cet en-tete : 

template <class charT, 

class traits = char_traits<charT> > 
class basic_of stream : public basic_ostream<charT, traits> 
{ 

public : 
// Les types de donnees : 
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typedef charT char_type; 

typedef typename traits :: int_type int_type; 

typedef typename traits : :pos_type pos_type; 

typedef typename traits :: of f_type off_type; 

// Les constructeurs et destructeurs : 
basic_of stream ( ) ; 
explicit basic_of stream (const char *nom, 

ios_base : : openmode mode = ios_base : : out I ios_base : : trunc) ; 

// Les methodes de gestion du fichier : 

basic_f ilebuf <charT, traits> *rdbuf () const; 

bool is_open ( ) ; 

void open (const char *nom, ios_base :: openmode mode = out I trunc); 

void close ( ) ; 
}; 



Comme pour les flux d'entree / sortie sur les chaines de caracteres, il est possible d'initialiser le flux 
des sa construction ou a posteriori. Les methodes importantes sont bien entendu la methode open, 
qui permet d'ouvrir un fichier, la methode is_open, qui permet de savoir si le flux contient deja un 
fichier ouvert ou non, et la methode close, qui permet de fermer le fichier ouvert. 

Exemple 15-10. Utilisation de flux d'entree / sortie sur un fichier 

#include <iostream> 
#include <fstream> 
tinclude <string> 

using namespace std; 

int main (void) 
{ 

// Lit les donnees : 

int i; 

double d, e; 

cout << "Entier Reel Reel : "; 

cin >> i >> d >> e; 

// Enregistre ces donnees dans un fichier : 

of stream f ( "fichier . txt" ) ; 

if (f . is_open ( ) ) 

{ 

f << "Les donnees lues sont : " << 

i << " " << d << " " << e << endl; 

f . close ( ) ; 
} 
return 0; 



Note : II est important de bien noter que le destructeur des flux ne ferme pas les fichiers. En effet, 
ce sont les tampons utilises de maniere sous-jacente par les flux qui realisent les operations sur 
les fichiers. II est meme tout a fait possible d'acceder a un meme fichier avec plusieurs classes de 
flux, bien que cela ne soit pas franchement recommande. Vous devrez done prendre en charge 
vous-meme les operations d'ouverture et de fermeture des fichiers. 
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Bien entendu, les classes de flux permettant d'acceder a des fichiers heritent des methodes de position- 
nement de leurs classes de base. Ainsi, les classes de lecture dans un fichier disposent des methodes 
tellg et seekg, et les classes d'ecriture disposent des methodes tellp et seekp. Ces operations 
permettent respectivement de lire et de fixer une nouvelle valeur du pointeur de position du fichier 
courant. 

Exemple 15-11. Repositionnement du pointeur de fichier dans un flux d'entree / sortie 

#include <iostream> 
#include <fstream> 
#include <string> 

using namespace std; 

int main (void) 
{ 

// Ouvre le fichier de donnees : 
fstream f ( "fichier .txt" , 

ios_base::in | ios_base : : out I ios_base : : trunc) ; 
if (f . is_open ( ) ) 
{ 

// Ecrit les donnees : 

f << 2 << " " << 45.32 << " " << 6.37 << endl; 

// Replace le pointeur de fichier au debut : 

f . seekg (0) ; 

// Lit les donnees : 

int i; 

double d, e; 

f >> i >> d >> e; 

cout << "Les donnees lues sont : " << 

i << " " << d << " " << e << endl; 

// Ferme le fichier : 

f . close ( ) ; 
} 
return 0; 



Note : Les classes d'entree / sortie sur fichier n'utilisent qu'un seul tampon pour acceder aux 
fichiers. Par consequent, il n'existe qu'une seule position dans le fichier, qui serf a la fois a la 
lecture et a I'ecriture. 
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II existe de nombreux alphabets et de nombreuses manieres d'ecrire les nombres, les dates et les 
montants de part le monde. Chaque pays, chaque culture dispose en effet de ses propres conventions 
et de ses propres regies, et ce dans de nombreux domaines. Par exemple, les Anglo-saxons ont pour 
coutume d'utiliser le point (caractere ' . ') pour separer les unites de la virgule lorsqu'ils ecrivent des 
nombres a virgule et d'utiliser une virgule (caractere ', ') entre chaque groupe de trois chiffres pour 
separer les milliers des millions, les millions des milliards, etc. En France, c'est la virgule est utilisee 
pour separer les unites de la partie fractionnaire des nombres a virgule, et le separateur des milliers 
est simplement un espace. De meme, ils ont l'habitude d'ecrire les dates en mettant le mois avant les 
jours, alors que les Francais font l'inverse. 

II va de soi que ce genre de differences rend techniquement tres difficile l'internationalisation des 
programmes. Une solution est tout simplement de dire que les programmes travaillent dans une langue 
« neutre », ce qui en pratique revient souvent a dire l'anglais puisque c'est la langue historiquement 
la plus utilisee en informatique. Helas, si cela convenait parfaitement aux programmeurs, ce ne serait 
certainement pas le cas des utilisateurs ! II faut done, a un moment donne ou a un autre, que les 
programmes prennent en compte les conventions locales de chaque pays ou de chaque peuple. 

Ces conventions sont extremement nombreuses et portent sur des domaines aussi divers et varies que 
la maniere d'ecrire les nombres, les dates ou de coder les caracteres et de classer les mots dans un 
dictionnaire. En informatique, il est courant d'appeler 1' ensemble des conventions d'un pays la locale 
de ce pays. Les programmes qui prennent en compte la locale sont done dits localises et sont capables 
de s'adapter aux preferences nationales de l'utilisateur. 

Note : Le fait d'etre localise ne signifie pas pour autant pour un programme que tous ses mes- 
sages sont traduits dans la langue de l'utilisateur. La localisation ne prend en compte que les 
aspects concernant I'ecriture des nombres et les alphabets utilises. Afin de bien faire cette dis- 
tinction, on dit que les programmes capables de communiquer avec l'utilisateur dans sa langue 
sont internationalises. La conversion d'un programme d'un pays a un autre necessite done a la 
fois la localisation de ce programme et son internationalisation. 



Si la traduction de tous les messages d'un programme ne peut pas etre realisee automatiquement, il 
est toutefois possible de prendre en compte les locales relativement facilement. En effet, les fonc- 
tionnalites des bibliotheques C et C++, en particulier les fonctionnalites d' entree / sortie, peuvent 
generalement etre parametrees par la locale de l'utilisateur. La gestion des locales est done com- 
pletement prise en charge par ces bibliotheques et un meme programme peut done etre utilise sans 
modification dans divers pays. 

Note : En revanche, la traduction des messages ne peut bien evidemment pas etre prise en 
charge par la bibliotheque standard, sauf eventuellement pour les messages d'erreur du systeme. 
La realisation d'un programme international necessite done de prendre des mesures particulieres 
pour faciliter la traduction de ces messages. En general, ces mesures consistent a isoler les 
messages dans des modules specifiques et a ne pas les utiliser directement dans le code du 
programme. Ainsi, il suffit simplement de traduire les messages de ces modules pour ajouter le 
support d'une nouvelle langue a un programme existant. Le code source n'a ainsi pas a etre 
touche, ce qui limite les risques d'erreurs. 



La gestion des locales en C++ se fait par 1' intermediate d'une classe generale, la classe locale, qui 
permet de stacker tous les parametres locaux des pays. Cette classe est bien entendu utilisee par les 
flux d' entree / sortie de la bibliotheque standard, ce qui fait que vous n'aurez generalement qu'a 
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initialiser cette classe au debut de vos programmes pour leur faire prendre en compte les locales. 
Cependant, il se peut que vous ayez a manipuler vous-meme des locales ou a definir de nouvelles 
conventions nationales, surtout si vous ecrivez des surcharges des operateurs de formatage des flux 
operator<< et operator>>. Ce chapitre presente done les notions generates des locales, les dif- 
ferentes classes mises en oeuvre au sein d'une meme locale pour prendre en charge tous les aspects de 
la localisation, et la maniere de definir ou de redefinir un de ces aspects afin de completer une locale 
existante. 



16.1. Notions de base et principe de fonctionnement des facettes 

Comme il l'a ete dit plus haut, les locales comprennent differents aspects qui traitent chacun d'une 
des conventions nationales de la locale. Par exemple, la maniere d'ecrire les nombres constitue un de 
ces aspects, tout comme la maniere de classer les caracteres ou la maniere d'ecrire les heures et les 
dates. 

Chacun de ces aspects constitue ce que la bibliotheque standard C++ appelle une face tte. Les facettes 
sont gerees par des classes C++, dont les methodes permettent d'obtenir les informations specifiques 
aux donnees qu'elles manipulent. Certaines facettes fournissent egalement des fonctions permettant 
de formater et d'interpreter ces donnees en tenant compte des conventions de leur locale. Chaque 
facette est identified de maniere unique dans le programme, et chaque locale contient une collection 
de facettes decrivant tous ses aspects. 

La bibliotheque standard C++ fournit bien entendu un certain nombre de facettes predefinies. Ces 
facettes sont regroupees en categories qui permettent de les classer en fonction du type des operations 
qu'elles permettent de realiser. La bibliotheque standard definit six categories de facettes, auxquelles 
correspondent les valeurs de six constantes de la classe locale : 

• la categorie ctype, qui regroupe toutes les facettes permettant de classifier les caracteres et de les 
convertir d'un jeu de caractere en un autre ; 

• la categorie collate, qui comprend une unique facette permettant de comparer les chaines de 
caracteres en tenant compte des caracteres de la locale courante et de la maniere de les utiliser dans 
les classements alphabetiques ; 

la categorie numeric, qui comprend toutes les facettes prenant en charge le formatage des 
nombres ; 

• la categorie monetary, qui comprend les facettes permettant de determiner les symboles mone- 
taires et la maniere d'ecrire les montants ; 

• la categorie time, qui comprend les facettes capables d'effectuer le formatage et l'ecriture des 
dates et des heures ; 

• la categorie message, qui contient une unique facette permettant de faciliter l'internationalisation 
des programmes en traduisant les messages destines aux utilisateurs. 



Bien entendu, il est possible de definir de nouvelles facettes et de les inclure dans une locale existante. 
Ces facettes ne seront evidemment pas utilisees par les fonctions de la bibliotheque standard, mais le 
programme peut les recuperer et les utiliser de la meme maniere que les facettes standards. 

Les mecanismes de definition, d' identification et de recuperation des facettes, sont tous pris en charge 
au niveau de la classe locale. La declaration de cette classe est realisee de la maniere suivante dans 
l'en-tete locale : 

class locale 
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public : 

// Les types de donnees : 

// Les categories de facettes : 

typedef int category; 

static const category // Les valeurs de ces constantes 

{ // sont specifiques a chaque implementation 

none = VALO, 

ctype = VAL1, collate = VAL2, 

numeric = VAL3, monetary = VAL4, 

time = VAL5, messages = VAL6, 

all = collate I ctype | monetary | numeric I time | messages; 
}; 

// La classe de base des facettes : 

class facet 

{ 

protected: 

explicit facet (size_t ref s = 0) ; 

virtual -facet (); 
private : 

// Ces methodes sont declarees mais non definies : 

facet (const facet &); 

void operator= (const facet &); 
}; 

// La classe d' identification des facettes : 
class id 
{ 
public : 

id() ; 
private : 

// Ces methodes sont declarees mais non definies : 
void id(const id & ) ; 
void operator= (const id &); 

}; 

// Les constructeurs : 
locale ( ) throw ( ) 

explicit locale (const char *nom) ; 
locale (const locale &) throw (); 

locale (const locale Sinit, const char *nom, category c) ; 
locale (const locale Sinitl, const locale &init2, category c) ; 

template <class Facet> 

locale (const locale Sinit, Facet *f ) ; 

template <class Facet> 

locale (const locale Sinitl, const locale &init2); 

// Le destructeur : 

-locale () throw (); 

// Operateur d' affectation : 

const locale &operator= (const locale Ssource] throw (); 

// Les methodes de manipulation des locales : 
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basic_string<char> named const; 

bool operator== (const locale S) const; 

bool operator != (const locale &) const; 

template <class charT, class Traits, class Allocator> 

bool operator () ( 

const basic_string<charT, Traits, Allocator> &sl, 

const basic_string<charT, Traits, Allocator> &s2) const; 

// Les methodes de selection des locales : 

static locale global (const locale &); 

static const locale Selassie (); 
}; 



Comme vous pouvez le constater, outre les constructeurs, destructeur et methodes generates, la classe 
locale contient la declaration de deux sous-classes utilisees pour la definition des facettes : la classe 
facet et la classe id. 

La classe facet est la classe de base de toutes les facettes. Son role est essentiellement d'eviter que 
Ton puisse dupliquer une facette ou en copier une, ce qui est realise en declarant en zone privee le 
constructeur de copie et l'operateur d' affectation. Comme ces methodes ne doivent pas etre utilisees, 
elles ne sont pas definies non plus, seule la declaration est fournie par la bibliotheque standard. Notez 
que cela n'est pas derangeant pour 1' utilisation de la classe facet, puisque comme ces methodes ne 
sont pas virtuelles et qu'elles ne seront jamais utilisees dans les programmes, l'editeur de liens ne 
cherchera pas a les localiser dans les fichiers objets du programme. Ainsi, les instances de facettes 
ne peuvent etre ni copiees, ni dupliquees. En fait, les facettes sont destinees a etre utilisees au sein 
des locales, qui prennent en charge la gestion de leur duree de vie. Toutefois, si Ton desire gerer soi- 
meme la duree de vie d'une facette, il est possible de le signaler lors de la construction de la facette. 
Le constructeur de base de la classe facet prend en effet un parametre unique qui indique si la duree de 
vie de la facette doit etre prise en charge par la locale dans laquelle elle se trouve ou si elle devra etre 
explicitement detruite par le programmeur (auquel cas ce parametre doit etre fixe a 1). En general, la 
valeur par defaut convient dans la majorite des cas et il n'est pas necessaire de fournir de parametre 
au constructeur des facettes. 

La classe id quant a elle est utilisee pour definir des identifiants uniques pour chaque classe de facette. 
Ces identifiants permettent a la bibliotheque standard de distinguer les facettes les unes des autres, 
a l'aide d'une clef unique dont le format n'est pas specifie, mais qui est determinee par la classe 
id automatiquement lors de la premiere creation de chaque facette. Cet identifiant est en particulier 
utilise pour retrouver les facettes dans la collection des facettes gerees par la classe locale. 

Pour que ce mecanisme d'enregistrement fonctionne, il faut que chaque classe de facette definisse une 
donnee membre statique i d en zone publique, dont le type est la sous-classe id de la classe locale. 
Cette donnee membre etant statique, elle appartient a la classe et non a chaque instance, et permet 
done bien d' identifier chaque classe de facette. Lors du chargement du programme, les variables 
statiques sont initialisees a 0, ce qui fait que les facettes disposent toutes d'un identifiant nul. Ceci 
permet aux methodes de la bibliotheque standard de determiner si un identifiant a deja ete attribue a la 
classe d'une facette ou non lorsqu'elle est utilisee pour la premiere fois. Si e'est le cas, cet identifiant 
est utilise tel quel pour referencer cette classe, sinon, il est genere automatiquement et stocke dans la 
donnee membre id de la classe. 

Ainsi, pour definir une facette, il suffit simplement d'ecrire une classe derivant de la classe lo- 
cale::facet et contenant une donnee membre statique et publique id de type locale::id. Des lors, cette 
facette se verra attribuer automatiquement un identifiant unique, qui permettra d'utiliser les fonctions 
de recherche de facettes dans les locales. Ces fonctions utilisent bien entendu la donnee membre id 
du type de la facette a rechercher et s'en servent en tant qu'index dans la collection des facettes de la 
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locale a utiliser. La maniere de realiser ces operations n'est pas decrite par la norme du C++, mais le 
principe est la. 

Les fonctions de recherche des facettes sont egalement declarees dans l'en-tete locale. Ce sont des 
fonctions template parametrees par le type des facettes, qui prennent en parametre la locale dans 
laquelle la facette doit etre recherchee : 

template <class Facet> 

const Facet &use_facet (const locale &); 

template <class Facet> 

bool has_facet (const locale &); 



La fonction use_f acet permet de recuperer l'instance d'une facette dans la locale passee en para- 
metre. Comme la signature de cette fonction template ne permet pas de determiner le type de la 
facette, et done l'instance a utiliser pour l'appel, il est necessaire de specifier explicitement ce type 
entre crochets apres le nom de la fonction. Par exemple, pour recuperer la facette num_put<char> de 
la locale classique de la bibliotheque C, on fera l'appel suivant : 

use_f acet<num_put<char> > (locale : : classic ( ) ) ; 



Les facettes fournies par la bibliotheque standard sont generalement disponibles et peuvent etre uti- 
lisees avec les locales. Les methodes specifiques a chacune de ces facettes peuvent done etre appe- 
lees sur la reference de la facette retournee par la fonction use_facet. En revanche, les facettes 
definies par l'utilisateur peuvent ne pas etre presentes dans la locale fournie en parametre a la fonc- 
tion use_f acet. Dans ce cas, cette fonction lance une exception de type bad_cast. Comme il peut 
etre utile en certaines circonstances de determiner dynamiquement si une locale contient ou non une 
facette, la bibliotheque standard met a disposition la fonction globale has_facet. Cette fonction 
s'utilise de la meme maniere que la fonction use_facet, mais au lieu de renvoyer la facette de- 
manded, elle retourne un booleen indiquant si la locale fournie en parametre contient ou non cette 
facette. 

Les programmes peuvent creer plusieurs locales afin de prendre en compte plusieurs jeux de para- 
metres internationaux s'ils le desirent, mais ils doivent dans ce cas manipuler ces locales eux-memes 
dans toutes les operations susceptibles d' utiliser la notion de locale. Par exemple, ils doivent specifier 
la locale a utiliser avant chaque operation d'entree / sortie en appelant la methode imbue des flux 
utilises. Comme cela n'est pas tres pratique, la bibliotheque standard definit une locale globale, qui 
est la locale utilisee par defaut lorsqu'un programme ne desire pas specifier explicitement la locale a 
utiliser. Cette locale peut etre recuperee a tout moment en creant un simple objet de type locale, en 
utilisant le constructeur par defaut de la classe locale. Ce constructeur initialise en effet la locale en 
cours de construction avec tous les parametres de la locale globale. Ainsi, pour recuperer la facette 
num_put<char> de la locale globale, on fera l'appel suivant : 

use_f acet<num_put<char> > (locale ( ) ) ; 

Vous remarquerez que la locale fournie en parametre a la fonction use_f acet n'est plus, contraire- 
ment a l'exemple precedent, la locale renvoyee par la methode statique classic de la classe locale, 
mais une copie de la locale globale. 

II est possible de construire une locale specifique explicitement avec le constructeur de la classe 
locale qui prend le nom de la locale a utiliser en parametre. Ce nom peut etre l'un des noms standards 
"C", " ", ou toute autre valeur dont la signification n'est pas normalised. Le nom de locale vide (" ") 



321 



Chapitre 16. Les locales 



permet de construire une locale dont les parametres sont initialises en fonction de l'environnement 
d' execution du programme. C'est done la valeur que Ton utilisera en general, car cela permet de 
parametrer le comportement des programmes facilement, sans avoir a les modifier et a les recompiler. 

Note : La maniere de definir la locale dans l'environnement d'execution des programmes est 
specifique a chaque systeme d'exploitation et n'est normalise ni par la norme C++, ni par la 
norme C. La norme POSIX precise cependant que cela peut etre realise par I'intermediaire de 
variables d'environnement. Par exemple, si la variable d'environnement LANG n'est pas definie, la 
locale utilisee sera la locale de la bibliotheque C. En revanche, si cette variable d'environnement 
contient la valeur "fr_FR", la locale utilisee sera celle des francophones de France. Les formats 
des nombres, des dates, etc. utilises seront done ceux qui sont en vigueur en France. 



Les autres constructeurs de la classe locale permettent de creer de nouvelles locales en recopiant les 
facettes d'une locale existante, eventuellement en ajoutant de nouvelles facettes non standards ou en 
redefinissant certaines facettes de la locale modele. Bien entendu, le constructeur de copie recopie 
toutes les facettes de la locale source dans la locale en cours de construction. Les deux construc- 
teurs suivants permettent de recopier toutes les facettes d'une locale, sauf les facettes identifiees par 
la categorie specifiee en troisieme parametre. Pour cette categorie, les facettes utilisees sont celles 
de la locale specifiee en deuxieme parametre. II est possible ici d' identifier cette deuxieme locale 
soit par son nom, soit directement par I'intermediaire d'une reference. Enfin, les deux constructeurs 
template permettent de creer une locale dont toutes les facettes sont initialisees a partir d'une lo- 
cale fournie en parametre, sauf la facette dont le type est utilise en tant que parametre template. 
Pour cette facette, la valeur a utiliser peut etre specifiee directement en deuxieme parametre ou ex- 
traite d'une autre locale, elle aussi specifiee en deuxieme parametre. Nous verrons plus en detail dans 
la Section 16.3 la maniere de proceder pour inserer une nouvelle facette ou remplacer une facette 
existante. 

Enfin, la classe locale dispose de deux methodes statiques permettant de manipuler les locales du pro- 
gramme. La methode classic que Ton a utilisee dans l'un des exemples precedents permet d'obtenir 
la locale representant les options de la bibliotheque C standard. Cette locale est la locale utilisee par 
defaut par les programmes qui ne definissent pas les locales utilisees. La methode global quant a 
elle permet de specifier la locale globale du programme. Cette methode prend en parametre un objet 
de type locale a partir duquel la locale globale est initialisee. II est done courant de faire un appel a 
cette methode des le debut des programmes C++. 

Exemple 16-1. Programme C++ prenant en compte la locale de l'environnement 

#include <ctime> 
#include <iostream> 
tinclude <locale> 

using namespace std; 

int main (void) 
{ 

// Utilise la locale definie dans l'environnement 

// d'execution du programme : 

locale: :global (locale ("") ) ; 

// Affiche la date courante : 

time_t date; 

time (Sdate) ; 

struct tm *TL = localtime (Sdate) ; 

use_f acet<time_put<char> > (locale ()) . put( 
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cout, cout, ' ', TL, ' c' ) ; 
cout << endl; 

// Affiche la date avec la fonction strftime 
// de la bibliotheque C : 
char s [ 64 ] ; 

strftime (s, 64, "%c", TL) ; 
cout << s << endl; 
return ; 



} 



La methode global de la classe global appelle automatiquement la methode setlocale si la locale 
fournie en parametre a un nom. Cela signifie que les locales de la bibliotheque standard C++ et celles 
de la bibliotheque standard C sont compatibles et utilisent les memes conventions de nommage. En 
particulier, les programmes qui veulent utiliser la locale definie dans leur environnement d' execution 
peuvent utiliser la locale anonyme "". C'est ce que fait le programme de l'exemple precedent, qui 
affiche la date au format de la locale definie par l'utilisateur en passant par les mecanismes du C++ 
(via la facette time_put, qui sera decrite en detail dans la Section 16.2.6) et par la fonction strftime 
de la bibliotheque C. 

Note : Les fonctions time, locaitime et strftime sont des fonctions de la bibliotheque C stan- 
dard. Elles permettent respectivement d'obtenir une valeur de type time_t representant la date 
courante, de la convertir en une structure contenant les differentes composantes de la date en 
temps local, et de formater cette date selon les conventions de la locale courante. Ces fonctions 
ne seront pas decrites plus en detail ici. Vous pouvez consulter la bibliographie si vous desirez 
obtenir plus de details sur la bibliotheque C et les fonctions qu'elle contient. 



16.2. Les facettes standards 

Cette section presente l'ensemble des facettes standards definies par la bibliotheque standard. La 
premiere partie decrit 1' architecture generale a laquelle les facettes standards se conforment, et les 
parties suivantes donnent une description des principales fonctionnalites fournies par chacune des 
categories de facettes. 

16.2.1. Generalites 

Les facettes fournies par la bibliotheque standard sont des classes template parametrees par le type 
des caracteres sur lesquels elles travaillent. Pour quelques-unes de ces facettes, la bibliotheque stan- 
dard definit une specialisation pour les types char ou wchar_t, specialisation dont le but est d'optimiser 
les traitements des facettes pour les flux d'entree / sortie standards sur ces types. 

Certaines de ces facettes ne sont utilisees que pour fournir des informations aux autres parties de la 
bibliotheque standard C++. D'autres, en revanche, permettent de realiser les operations de forma- 
tage et d'analyse syntaxique sur lesquelles les flux d'entree / sortie s'appuient pour implementer les 
operateurs operator<< et operator>>. Ces facettes disposent alors de methodes put et get qui 
permettent d'effectuer ces deux types d' operation. 

Les traitements effectues par les facettes doivent prendre en compte les parametres de leur locale ain- 
si que les options de formatage stockees dans les flux sur lesquelles les entrees / sorties doivent etre 
effectuees. Pour cela, les facettes doivent disposer d'un moyen de recuperer la locale dont elles font 
partie ou dont elles doivent utiliser les parametres. Generalement, les facettes qui realisent les opera- 
tions d'entree / sortie pour le compte des flux utilisent la methode getloc de ces derniers pour obtenir 
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la locale dont dies doivent utiliser les parametres. Les autres facettes ne peuvent pas proceder de la 
meme maniere, car elles ne disposent pas forcement d'un objet flux pour determiner la locale cou- 
rante. Afin de resoudre ce probleme, la bibliotheque standard definit des classes de facettes derivees 
et dont le constructeur prend en parametre le nom de la locale a laquelle ces facettes appartiennent. 
Ces classes sont done initialisees, des leur construction, avec le nom de la locale dans laquelle elles 
se trouvent, ce qui leur permet eventuellement d'effectuer des traitements dependants de cette locale. 
Les noms de ces classes de facettes derivees sont les memes que ceux de leurs classes de base, a 
ceci pres qu'ils sont suffixes par la chaine « _byname ». Par exemple, la facette ctype, qui, comme 
on le verra plus loin, permet de classer les caracteres selon leur nature, dispose d'une classe derivee 
ctype_byname dont le constructeur prend en parametre le nom de la locale dont la facette fait partie. 

Note : Les implementations de la bibliotheque standard fournies avec les environnements de 
developpement C++ ne sont pas tenues de fournir ces facettes pour chaque locale existante dans 
le monde. En realite, quasiment aucun environnement ne le fait a I'heure actuelle. En revanche, 
toutes les facettes standards doivent au moins etre fournies et fonctionner correctement avec les 
locales "c" et "". 



Les facettes sont ecrites de telle maniere qu' elles peuvent facilement etre remplacees par des fa- 
cettes plus specifiques. Ainsi, leurs methodes publiques appellent toutes des methodes virtuelles, qui 
peuvent parfaitement etre redefinies par des classes derivees desirant remplacer l'un des traitements 
effectues par la bibliotheque standard. 

Generalement, les noms des methodes virtuelles sont les memes que ceux des methodes publiques qui 
les utilisent, precedes du prefixe « do_ ». Par exemple, si une facette fournit une methode publique 
nommee put, la methode virtuelle appelee par celle-ci se nommera do_put. La maniere de redefinir 
les methodes d'une facette existante et de remplacer cette facette par une de ses classes derivees dans 
une locale sera decrite en detail dans la Section 16.3.2. 



16.2.2. Les facettes de manipulation des caracteres 

La bibliotheque standard definit deux facettes permettant de manipuler les caracteres. La premiere 
facette, la facette ctype, fournit les fonctions permettant de classer les caracteres en differentes cate- 
gories. Ces categories comprennent les lettres, les chiffres, les caracteres imprimables, les caracteres 
graphiques, etc. La deuxieme facette permet quant a elle d'effectuer les conversions entre les diffe- 
rents types existants d'encodage de caracteres. II s'agit de la facette code_cvt. 

16.2.2.1. La facette ctype 

La facette ctype derive d'une classe de base dans laquelle sont definies les differentes categories de 
caracteres. Cette classe est declaree comme suit dans l'en-tete locale : 

class ctype_base 

{ 

public : 

enum mask 
{ 

space = SPACE_VALUE, print = PRINT_VALUE, 

cntrl = CNTRL_VALUE, alpha = ALPHA_VALUE, 

digit = DIGIT_VALUE, xdigit = XDIGIT_VALUE, 

upper = UPPER_VALUE, lower = LOWER_VALUE, 

punct = PUNCT_VALUE, 

alnum = alpha I digit, graph = alnum | punct 
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}; 

Les valeurs numeriques utilisees par cette enumeration sont definies de telle maniere que les 
constantes de type mask constituent un champ de bits. Ainsi, il est possible de definir des 
combinaisons entre ces valeurs, certains caracteres pouvant appartenir a plusieurs categories en 
meme temps. Deux combinaisons standards sont d'ailleurs definies, alnum, qui caracterise les 
caracteres alphanumeriques, et graph, qui represente tous les caracteres alphanumeriques et de 
ponctuation. Les autres constantes permettent de caracteriser les caracteres selon leur nature et leur 
signification est en general claire. La seule constante qui dont 1' interpretation n'est pas immediate est 
la constante xdigit, qui identifie tous les caracteres pouvant servir de chiffre dans la notation des 
nombres hexadecimaux. Cela comprend les chiffres normaux et les lettres 'a' a 'f'. 

La classe template ctype quant a elle est declaree comme suit dans l'en-tete locale : 

template <class charT> 

class ctype : public locale :: facet, public ctype_base 

{ 

public : 

// Les types de donnees : 

typedef charT char_type; 

// Le constructeur : 

explicit ctype (size_t refs = 0); 

// Les methode de classification : 

bool is (mask m, charT c) const; 

const charT *is (const charT *premier, const charT *dernier, 

mask *vecteur) const; 
const charT *scan_is (mask m, 

const charT *premier, const charT *dernier) const; 
const charT *scan_not (mask m, 

const charT *premier, const charT *dernier) const; 
charT toupper (charT c) const; 

const charT *toupper (const charT *premier, const charT *dernier) const; 
charT tolower (charT c) const; 

const charT *tolower (const charT *premier, const charT *dernier) const; 
charT widen (char c) const; 
const charT *widen (const char *premier, const char *dernier, 

charT *destination) const; 
char narrow (charT c, char defaut) const; 

const char *narrow (const charT 'premier, const charT *dernier, 

char defaut, char 'destination) const; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Comme pour toutes les facettes standards, les methodes publiques deleguent leur travail a 
des methodes virtuelles declarees en zone protegee dont le nom est celui de la methode publique 
prefixe par la chame de caracteres « do_ ». Ces methodes peuvent etre redefinies par les classes 
derivees de la facette ctype et font done partie de I'interface des facettes standards. Cependant, 
elles ne sont pas representees dans la declaration donnee ci-dessus par souci de simplicity. Leur 
semantique est exactement la meme que celle des methodes publiques correspondantes. Nous 



325 



Chapitre 16. Les locales 



verrons dans la Section 1 6.3.2 la maniere de proceder pour redefinir certaines des methodes des 
facettes standards. 



Les methodes scan_is et scan_not permettent de rechercher un caractere selon un critere parti- 
culier dans un tableau de caracteres. La methode scan_is recherche le premier caractere qui est du 
type indique par son parametre m, et la methode scan_not le premier caractere qui n'est pas de ce 
type. Ces deux methodes prennent en parametre un pointeur sur le premier caractere du tableau dans 
lequel la recherche doit s'effectuer et le pointeur suivant l'emplacement du dernier caractere de ce 
tableau. Elles renvoient toutes les deux un pointeur referencant le caractere trouve, ou le pointeur de 
fin si aucun caractere ne verifie le critere specifie. 

Les autres methodes de la facette ctype sont fournies sous deux versions. La premiere permet 
d'effectuer une operation sur un caractere unique et la deuxieme permet de reproduire cette 
operation sur une sequence de caracteres consecutifs. Dans ce dernier cas, les caracteres sur lesquels 
F operation peut etre effectuee sont specifies a l'aide de deux pointeurs, l'un sur le premier caractere 
et 1' autre sur le caractere suivant le dernier caractere de la sequence, comme il est d' usage de le faire 
dans tous les algorithmes de la bibliotheque standard. 

Les deux methodes is permettent done respectivement de determiner si un caractere est du type 
indique par le parametre m ou non, ou d'obtenir la suite des descriptions de chaque caractere dans le 
tableau de valeur de type mask pointe par le parametre vecteur. De meme, les methodes toupper 
et to lower permettent respectivement de convertir un caractere unique ou tous les caracteres d'un 
tableau en majuscule ou en minuscule. La methode widen permet de transtyper un caractere ou tous 
les caracteres d'un tableau de type char en caracteres du type par lequel la classe ctype est parametree. 
Enfin, les methodes narrow permettent de realiser l'operation inverse, ce qui peut provoquer une perte 
de donnees puisque le type char est le plus petit des types de caracteres qui puisse exister. II est done 
possible que le transtypage ne puisse se faire, dans ce cas, les methodes narrow utilisent la valeur par 
defaut specifiee par le parametre def aut. 

Exemple 16-2. Conversion d'une wstring en string 

#include <iostream> 
#include <string> 
#include <locale> 

using namespace std; 

int main (void) 
{ 

// Fixe la locale globale aux preferences de 1' utilisateur : 

locale: :global (locale ("") ) ; 

// Lit une chaine de caracteres larges : 

wstring S; 

wcin >> S; 

// Recupere la facette ctype<wchar_t> de la locale courante : 

const ctype<wchar_t> &f = 

use_f acet<ctype<wchar_t> > (locale ( ) ) ; 

// Construit un tampon pour recevoir le resultat de la conversion : 

size_t 1 = S. length () + 1; 

char *tampon = new charfl]; 

// Effectue la conversion : 

f . narrow (S . c_str () , S.c_str() + 1, 'E', tampon); 

// Affiche le resultat : 

cout << tampon << endl; 
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delete [] tampon; 
return ; 



Note : Les conversions effectuees par les methodes narrow et widen ne travaillent qu'avec les 
representations de caracteres classiques du langage C++. Cela signifie que les caracteres sont 
tous representes par une unique valeur de type char ou wchar_t (ces methodes n'utilisent done 
pas de representation des caracteres basees sur des sequences de caracteres de longueurs 
variables). La methode narrow de I'exemple precedent ecrit done autant de caracteres dans le 
tampon destination qu'il y en a dans la chaine a convertir. 



Vous constaterez que 1' utilisation de la methode is pour determiner la nature des caracteres peut 
etre relativement fastidieuse, car il faut recuperer la facette ctype, determiner la valeur du masque a 
utiliser, puis appeler la methode. La bibliotheque standard definit done un certain nombre de fonctions 
globales utilitaires dans l'en-tete locale : 

template <class charT> bool isspace (charT c, const locale &1) const; 

template <class charT> bool isprint (charT c, const locale Si) const; 

template <class charT> bool iscntrl (charT c, const locale &1) const; 

template <class charT> bool isupper (charT c, const locale &1) const; 

template <class charT> bool islower (charT c, const locale Si) const; 

template <class charT> bool isalpha (charT c, const locale Si) const; 

template <class charT> bool isdigit (charT c, const locale Si) const; 

template <class charT> bool ispunct (charT c, const locale Si) const; 

template <class charT> bool isxdigit (charT c, const locale Si) const; 

template <class charT> bool isalnum (charT c, const locale Si) const; 

template <class charT> bool isgraph (charT c, const locale Si) const; 

template <class charT> charT toupper (charT c, const locale Si) const; 

template <class charT> charT tolower (charT c, const locale Si) const; 



L' utilisation de ces fonctions ne doit pas poser de probleme particulier. Elles prennent toutes en pre- 
mier parametre le caractere a caracteriser et en deuxieme parametre la locale dont la facette ctype 
doit etre utilisee pour realiser cette caracterisation. Chaque fonction permet de tester le caractere pour 
l'appartenance a l'une des categories de caracteres definies dans la classe de base ctype_base. Notez 
cependant que si un grand nombre de caracteres doivent etre caracterises pour une meme locale, il est 
plus performant d'obtenir la facette ctype de cette locale une bonne fois pour toutes et d'effectuer les 
appels a la methode is en consequence. 

La classe ctype etant une classe template, elle peut etre utilisee pour n'importe quel type de caractere 
a priori. Toutefois, il est evident que cette classe peut etre optimisee pour les types de caractere 
simples, et tout particulierement pour le type char, parce qu'il ne peut pas prendre plus de 256 valeurs 
differentes. La bibliotheque standard definit done une specialisation totale de la classe template 
ctype pour le type char. L' implementation de cette specialisation se base sur un tableau de valeurs de 
type mask indexee par les valeurs que peuvent prendre les variables de type char. Ce tableau permet 
done de determiner rapidement les caracteristiques de chaque caractere existant. Le constructeur de 
cette specialisation differe legerement du constructeur de sa classe template car il peut prendre 
en parametre un pointeur sur ce tableau de valeurs et un booleen indiquant si ce tableau doit etre 
detruit automatiquement par la facette lorsqu'elle est elle-meme detruite ou non. Ce constructeur 
prend egalement en troisieme parametre une valeur de type entier indiquant, comme pour toutes les 
facettes standards, si la locale doit prendre en charge la gestion de la duree de vie de la facette ou non. 
Les autres methodes de cette specialisation sont identiques aux methodes de la classe template de 
base et ne seront done pas decrites ici. 
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16.2.2.2. La facette codecvt 

La facette codecvt permet de realiser les operations de conversion d'un mode de representation des 
caracteres a un autre. En general, en informatique, les caracteres sont codes par des nombres. Le type 
de ces nombres, ainsi que la maniere de les utiliser, peut varier grandement d'une representation a une 
autre, et les conversions peuvent ne pas se faire simplement. Par exemple, certaines representations 
codent chaque caractere avec une valeur unique du type de caractere utilise, mais d'autres codent les 
caracteres sur des sequences de longueur variable. On ne peut dans ce cas bien entendu pas conver- 
tir directement une representation en une autre, car 1' interpretation que Ton peut faire des nombres 
representant les caracteres depend du contexte determine par les nombres deja lus. Les operations de 
conversion ne sont done pas toujours directes. 

De plus, dans certains encodages a taille variable, 1' interpretation des caracteres peut dependre des 
caracteres deja convertis. La facette codecvt maintient done un etat pendant les conversions qu'elle 
effectue, etat qui lui permet de reprendre la conversion d'une sequence de caracteres dans le cas 
de conversions realisees en plusieurs passes. Bien entendu, tous les encodages ne necessitent pas 
forcement le maintien d'un tel etat. Cependant, certains l'exigent et il faut done toujours le prendre 
en compte dans les operations de conversion si Ton souhaite que le programme soit portable. Pour 
les sequences de caracteres a encodage variable utilisant le type de caractere de base char, le type de 
la variable d'etat permettant de stocker l'etat courant du convertisseur est le type mbstate_t. D'autres 
types peuvent etre utilises pour les sequences basees sur des types de caracteres differents du type 
char, mais en general, tous les encodages a taille variable se basent sur ce type. Quoi qu'il en soit, 
la classe codecvt definit un type de donnee capable de stocker l'etat d'une conversion partielle. Ce 
type est le type state_type, qui pourra done toujours etre recupere dans la classe codecvt. La variable 
d'etat du convertisseur devra etre systematiquement fournie aux methodes de conversion de la facette 
codecvt et devra bien entendu etre initialisee a sa valeur par defaut au debut de chaque nouvelle 
conversion. 

Note : La facette codecvt permet de realiser les conversions d'une representation des carac- 
teres a une autre, mais n'a pas pour but de changer I'encodage des caracteres, e'est-a-dire 
I'association qui est faite entre les sequences de nombres et les caracteres. Cela signifie que 
la facette codecvt permet par exemple de convertir des chaines de caracteres larges wchar_t en 
sequences de longueurs variables de caracteres de type char, mais elle ne permet pas de passer 
d'une page de codes a une autre. 



La facette codecvt derive d'une classe de base nominee codecvt_base. Cette classe definit les dif- 
ferents resultats que peuvent avoir les operations de conversion. Elle est declaree comme suit dans 
l'en-tete locale : 

class codecvt_base 

{ 

public : 

enum result 

{ 

ok, partial, error, noconv 

}; 
}; 



Comme vous pouvez le constater, une conversion peut se realiser completement (code de resultat ok), 
partiellement par manque de place dans la sequence destination ou par manque de donnees en entrees 
(code partial), ou pas du tout, soit en raison d'une erreur de conversion (code d'erreur error), soit 
parce qu'aucune conversion n'est necessaire (code de resultat noconv). 



328 



Chapitre 16. Les locales 

La classe template codecvt elle-meme est definie comme suit dans l'en-tete locale : 

template <class internT, class externT, class stateT> 

class codecvt : public locale :: facet, public codecvt_base 

{ 

public : 

// Les types de donnees : 

typedef internT intern_type; 

typedef externT extern_type; 

typedef stateT state_type; 

// Le constructeur : 

explicit codecvt (size_t refs=0); 

// Les fonctions de conversion : 

result out (stateT Set at/ const internT *premier, 

const internT *dernier, const internT *&suiv_source, 

externT *dernier, externT *limite, externT *Ssuiv_dest) const; 

result in (stateT setat, const externT *premier, 

const externT *dernier, const externT *&suiv_source, 

internT *dernier, internT *limite, internT *Ssuiv_dest) const; 

result unshift (stateT setat, 

externT *dernier, externT *limite, externT *&suiv_dest) const; 

int length (const stateT setat, 

const externT *premier, const externT *dernier, size_t max) const; 

int max_length ( ) const throw (); 

int encoding () const throw (); 

bool always_noconv ( ) const throw (); 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



Cette classe template est parametree par le type de caractere interne a la classe codecvt, par un 
deuxieme type de caractere qui sera par la suite denomme type externe, et par le type des variables 
destinees a recevoir l'etat courant d'une conversion. Les implementations de la bibliotheque standard 
doivent obligatoirement instancier cette classe template pour les types char et wchar_t. Le type de 
gestion de l'etat des conversions utilise est alors le type predefini mbstate_t, qui permet de conser- 
ver l'etat des conversions entre le type natif wchar_t et les sequences de caracteres simples a taille 
variable. Ainsi, vous pourrez toujours utiliser les instances codecvt<wchar_t, char, mbstate_t> et 
codecvt<char, char, mbstate_t> de la facette codecvt dans vos programmes. Si vous desirez realiser 
des conversions pour d'autres types de caracteres, vous devrez fournir vous-meme des specialisations 
de la facette codecvt. 

Les methodes in et out permettent respectivement, comme leurs signatures l'indiquent, de realiser 
les conversions entre les types interne et externe et vice versa. Elles prennent toutes deux sept para- 
metres. Le premier parametre est une reference sur la variable d'etat qui devra etre fournie a chaque 
appel lors de conversions successives d'un meme flux de donnees. Cette variable est destinee a re- 
cevoir l'etat courant de la conversion et permettra aux appels suivants de convertir correctement les 
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caracteres suivants du flux d' entree. Les deux parametres suivants permettent de specifier la sequence 
de caracteres a convertir. lis doivent contenir le pointeur sur le debut de la sequence et le pointeur sur 
le caractere suivant le dernier caractere de la sequence. Le quatrieme parametre est un parametre de 
retour, la fonction lui affectera la valeur du pointeur ou la conversion s'est arretee. Une conversion 
peut s'arreter a cause d'une erreur ou tout simplement parce que le tampon destination ne contient 
pas assez de place pour accueillir un caractere de plus. Ce pointeur pourra etre utilise dans un ap- 
pel ulterieur comme pointeur de depart avec la valeur de la variable d'etat a Tissue de la conversion 
pour effectuer la suite de cette conversion. Enfin, les trois derniers parametres specifient le tampon 
destination dans lequel la sequence convertie doit etre ecrite. lis permettent d'indiquer le pointeur de 
debut de ce tampon, le pointeur suivant le dernier emplacement utilisable, et un pointeur de retour 
qui indiquera la derniere position ecrite par V operation de conversion. Ces deux methodes renvoient 
une des constantes de 1' enumeration result definie dans la classe de base codec vt_base pour indiquer 
comment la conversion s'est effectuee. Si aucune conversion n'est necessaire, les pointeurs sur les 
caracteres suivants sont initialises a la valeur des pointeurs de debut de sequence et aucune ecriture 
n'a lieu dans le tampon destination. 

Exemple 16-3. Conversion d'une chaine de caracteres larges en chaine a encodage variable 

#include <iostream> 
#include <string> 
#include <locale> 

using namespace std; 

int main (void) 
{ 

// Fixe la locale globale : 

locale: :global (locale ("") ) ; 

// Lit une ligne : 

wstring S; 

getline (wcin, S); 

// Recupere la facette de conversion vers wchar_t : 

const codecvt<wchar_t, char, mbstate_t> &f = 

use_f acet<codecvt<wchar_t , char, mbstate_t> > (locale ()) ; 
// Effectue la conversion : 
const wchar_t *premier = S.c_str(); 
const wchar_t *dernier = premier + S . length () ; 
const wchar_t *suivant = premier; 
string s; 
char tampon [10] ; 
char *fincvt = tampon; 
codecvt_base :: result r; 
mbstate_t etat = mbstate_t(); 
while (premier != dernier) 
{ 

// Convertit un morceau de la chaine : 

r = f. out (etat, premier, dernier, suivant, 
tampon, tampon+10, fincvt); 

// Verifie les erreurs possibles : 

if (r == codecvt_base : : ok | | r == codecvt_base : :partial ) 
cout << "." << flush; 

else if (r == codecvt_base : : noconv) 

{ 

cout << "conversion non necessaire" << endl; 
break; 
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} 

else if (r == codecvt_base :: error ) 

{ 

cout << "erreur" << endl; 
cout << suivant - premier << endl; 
cout << fincvt - tampon << endl; 
break ; 
} 

// Recupere le resultat et prepare la conversion suivante 
s . append (tampon, fincvt - tampon); 
premier = suivant; 
} 

cout << endl; 
// Affiche le resultat : 
cout << s << endl; 
return 0; 



Note : Si Ton desire effectuer une simple conversion d'une chaine de caracteres de type wchar_t 
en chaine de caracteres C classique, on cherchera plutot a utiliser la methode narrow de la 
facette ctype presentee dans la section precedente. En effet, la facette codecvt utilise, a priori, 
une sequence de caracteres avec un encodage a taille variable, ce qui ne correspond pas a la 
representation des chames de caracteres C classiques, pour lesquelles chaque valeur de type 
char represente un caractere. 



II est possible de completer une sequence de caracteres a encodage variable de telle sorte que la 
variable d'etat du convertisseur soit reinitialisee. Cela permet de terminer une chaine de caracteres 
partiellement convertie, ce qui en pratique revient a completer la sequence de caracteres avec les 
donnees qui representeront le caractere nul terminal. Cette operation peut etre realisee a l'aide de 
la methode unshift de la facette codecvt. Cette methode prend en parametre une reference sur la 
variable d'etat du convertisseur, ainsi que les pointeurs de debut et de fin du tampon dans lequel les 
valeurs a ajouter sont ecrites. Le dernier parametre de la methode unshift est une reference sur un 
pointeur qui recevra 1'adresse suivant celle la derniere valeur ecrite par la methode si 1'operation se 
deroule correctement. 

II va de soi que la determination de la longueur d'une chaine de caracteres dont les caracteres ont 
une representation a taille variable n'est pas simple. La facette codecvt comporte done une methode 
length permettant de calculer, en nombre de caracteres de type intern_type, la longueur d'une se- 
quence de caracteres de type extern_type. Cette methode prend en parametre la variable d'etat du 
convertisseur ainsi que les pointeurs specifiant la sequence de caracteres dont la longueur doit etre 
calculee. Le dernier parametre est la valeur maximale que la fonction peut retourner. Elle permet de 
limiter la determination de la longueur de la sequence source a une borne maximale, par exemple la 
taille d'un tampon destination. La valeur retournee est bien entendu la longueur de cette sequence 
ou, autrement dit, le nombre de valeurs de type intern_type necessaires pour stocker le resultat de 
la conversion que la methode in ferait avec les memes parametres. D'autre part, il est possible de 
determiner le nombre maximal de valeurs de type intern_type necessaires pour representer un unique 
caractere represente par une sequence de caracteres de type extern_type. Pour cela, il suffit d'appeler 
la methode max_length de la facette codecvt. 

Exemple 16-4. Determination de la longueur d'une chaine de caracteres a encodage variable 

#include <iostream> 
#include <string> 
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#include <locale> 
#include <limits> 

using namespace std; 

int main (void) 
{ 

// Fixe la locale globale : 

locale: :global (locale ("") ) ; 

// Lit une ligne : 

string s; 

getline (cin, s) ; 

// Recupere la facette de conversion vers wchar_t : 

const codecvt<wchar_t, char, mbstate_t> &f = 

use_f acet<codecvt<wchar_t , char, mbstate_t> > (locale ()) ; 

// Affiche la longueur de la chaine d' entree : 

int 11 = s. length (); 

// Calcule la longueur de la ligne en wchar_t : 

mbstate_t etat = mbstate_t(); 

int 12 = f . length (etat, s.c_str(), s.c_str() + 11, 
numeric_limit s<size_t> : :max ( ) ) ; 

// Affiche les deux longueurs : 

cout << 11 << endl; 

cout << 12 << endl; 

return 0; 
} 

Comme on l'a deja indique ci-dessus, toutes les representations des caracteres ne sont pas a taille 
variable et toutes les representations ne necessitent pas forcement 1' utilisation d'une variable d'etat de 
type state_type. Vous pouvez determiner dynamiquement si le mode de representation des caracteres 
du type intern_type utilise un encodage a taille variable ou non a l'aide de la methode encoding. 
Cette methode renvoie -1 si la representation des caracteres de type extern_type depend de l'etat du 
convertisseur, ou le nombre de caracteres de type extern_type necessaires au codage d'un caractere de 
type intern_type si ce nombre est constant. Si la valeur renvoyee est 0, ce nombre n'est pas constant, 
mais, contrairement a ce qui se passe lorsque la valeur renvoyee est -1, ce nombre ne depend pas de 
la valeur de la variable d'etat du convertisseur. 

Enfin, certains modes de representation des caracteres sont compatibles, voire franchement identiques. 
Dans ce cas, jamais aucune conversion n'est realisee, et les methodes in et out renvoient toujours 
noconv. C'est par exemple le cas de la specialisation codecvt<char, char, mbstate_t> de la facette 
codecvt. Vous pouvez determiner si une facette effectuera des conversions ou non en appelant la 
methode always_noconv. Elle retourne true si jamais aucune conversion ne se fera et false sinon. 



16.2.3. Les facettes de comparaison de chaines 

Les chaines de caracteres sont generalement classees par ordre alphabetique, ou, plus precisement, 
dans l'ordre lexicographique. L' ordre lexicographique est l'ordre defini par la sequence des symboles 
lexicaux utilises (c'est-a-dire les symboles utilises pour former les mots du langage, done, en pratique, 
les lettres, les nombres, la ponctuation, etc.). Cet ordre est celui qui est defini par la comparaison 
successive des caracteres des deux chaines a comparer, le premier couple de caracteres differents 
permettant de donner un jugement de classement. Ainsi, les chaines les plus petites au sens de l'ordre 
lexicographique sont les chaines qui commencent par les premiers symboles du lexique utilise. Cette 
maniere de proceder suppose bien entendu que les symboles utilises pour former les mots du lexique 
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sont classes dans un ordre correct. Par exemple, il faut que la lettre 'a' apparaisse avant la lettre 'b', 
qui elle-meme doit apparaitre avant la lettre 'c', etc. 

Malheureusement, cela n'est pas si simple, car cet ordre n'est generalement pas celui utilise par les 
pages de codes d'une part, et il existe toujours des symboles speciaux dont la classification necessite 
un traitement special d' autre part. Par exemple, les caracteres accentues sont generalement places en 
fin de page de code et apparaissent done a la fin de l'ordre lexicographique, ce qui perturbe automa- 
tiquement le classement des chaines de caracteres contenant des accents. De meme, certaines lettres 
sont en realite des compositions de lettres et doivent etre prises en compte en tant que telles dans les 
operations de classement. Par exemple, la lettre '«' doit etre interpretee comme un 'a' suivi d'un 'e'. 
Et que dire du cas particulier des majuscules et des minuscules ? 

Comme vous pouvez le constater, il n'est pas possible de se baser uniquement sur l'ordre des carac- 
teres dans leur page de code pour effectuer les operations de classement de chaines de caracteres. De 
plus, il va de soi que l'ordre utilise pour classer les symboles lexicographiques depend de ces sym- 
boles et done de la locale utilise. La bibliotheque standard fournit done une facette prenant en compte 
tous ces parametres : la classe template collate. 

Le principe de fonctionnement de la facette collate est de transformer les chaines de caracteres uti- 
lisant les conventions de la locale a laquelle la facette appartient en une chaine de caracteres inde- 
pendante de la locale, comprenant eventuellement des codes de controle speciaux pour les caracteres 
specifiques a cette locale. Les chaines de caracteres ainsi transformees peuvent alors etre comparees 
entre elles directement, avec les methodes de comparaison classique de chaines de caracteres qui uti- 
lisent l'ordre lexicographique du jeu de caracteres du langage C. La transformation est effectuee de 
telle maniere que cette comparaison produit le meme resultat que la comparaison tenant compte de la 
locale des chaines de caracteres non transformees. 

La facette collate est declaree comme suit dans l'en-tete locale : 

template <class charT> 

class collate : public locale :: facet 

{ 

public : 

// Les types de donnees : 

typedef charT char_type; 

typedef basic_string<charT> string_type; 

// Le constructeur : 

explicit collate (size_t refs = 0); 

// Les methodes de comparaison de chaines : 

string_type transform (const charT *debut, const charT *fin) const; 
int compare (const charT *deb_premier , const charT *f in_premier, 

const charT *deb_deuxieme, const charT *f in_deuxieme) const; 
long hash (const charT *debut, const charT *fin) const; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 
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La methode transform est la methode fondamentale de la facette collate. C'est cette methode qui 
permet d'obtenir la chaine de caracteres transformee. Elle prend en parametre le pointeur sur le debut 
de la chaine de caracteres a transformer et le pointeur sur le caractere suivant le dernier caractere de 
cette chaine. Elle retourne une basic_string contenant la chaine transformee, sur laquelle les opera- 
tions de comparaison classiques pourront etre appliquees. 

II est possible d'effectuer directement la comparaison entre deux chaines de caracteres, sans avoir a 
recuperer les chaines de caracteres transformees. Cela peut etre realise grace a la methode compare, 
qui prend en parametre les pointeurs de debut et de fin des deux chaines de caracteres a comparer et qui 
renvoie un entier indiquant le resultat de la comparaison. Cet entier est negatif si la premiere chaine 
est inferieure a la deuxieme, positif si elle est superieure, et nul si les deux chaines sont equivalentes. 

Exemple 16-5. Comparaison de chaines de caracteres localisees 

#include <iostream> 
#include <string> 
#include <locale> 

using namespace std; 

int main (void) 
{ 

// Fixe la locale globale : 

locale: :global (locale ("") ) ; 

// Lit deux lignes en entree : 

cout << "Entrez la premiere ligne :" << endl; 

string si; 

getline (cin, si) ; 

cout << "Entrez la deuxieme ligne :" << endl; 

string s2; 

getline (cin, s2); 

// Recupere la facette de comparaison de chaines : 

const collate<char> &f = 

use_f acet<collate<char> > (locale ) ; 
// Compare les deux chaines : 
int res = f. compare ( 

sl.c_str(), sl.c_str() + si . length () , 

s2.c_str(), s2.c_str() + s2 . length ()) ; 
if (res < 0) 
{ 

cout << "\"" << si << "\" est avant \"" << 
s2 << "\"." << endl; 
} 

else if (res > 0) 
{ 

cout << "\"" << si << "\" est apres \"" << 
s2 << "\"." << endl; 
} 

else 
{ 

cout << "\"" << si << "\" est egale a \"" << 
s2 << "\"." << endl; 
} return 0; 
} 
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Note : La methode compare est tres pratique pour comparer deux chaines de caracteres de 
maniere ponctuelle. Cependant, on lui preferera la methode transform si un grand nombre de 
comparaisons doit etre effectue. En effet, il est plus simple de transformer toutes les chaines 
de caracteres une bonne fois pour toutes et de travailler ensuite directement sur les chaines 
transformees. Ce n'est que lorsque les operations de comparaison auront ete terminees que Ton 
pourra revenir sur les chaines de caracteres initiales. On evite ainsi de faire des transformation 
a repetition des chaines a comparer et on gagne ainsi beaucoup de temps. Bien entendu, cela 
necessite de conserver I'association entre les chaines de caracteres transformees et les chaines 
de caracteres initiales, et done de doubler la consommation memoire du programme due au 
chaines de caracteres pendant le traitement de ces chaines. 



Enfin, il est courant de chercher a determiner une clef pour chaque chaine de caracteres. Cette clef 
peut etre utilisee pour effectuer une recherche rapide des chaines de caracteres. La methode hash 
de la facette collate permet de calculer une telle clef, en garantissant que deux chaines de caracteres 
identiques au sens de la methode compare auront la meme valeur de clef. On notera cependant que 
cette clef n'est pas unique, deux chaines de caracteres peuvent avoir deux valeurs de clefs identiques 
meme si la methode compare renvoie une valeur non nulle. Cependant, ce cas est extremement rare, 
et permet d'utiliser malgre tout des algorithmes de recherche rapide. La seule chose a laquelle il faut 
faire attention est que ces algorithmes doivent pouvoir supporter les clefs multiples. 

Note : Les clefs a probability de recouvrement faible comme celle retournee par la mehtode hash 
sont generalement utilisees dans les structures de donnees appelees tables de hachage, ce qui 
explique le nom donne a cette methode. Les tables de hachage sont en realite des tableaux 
de listes chainees indexes par la clef de hachage (si la valeur de la clef depasse la taille du 
tableau, elle est ramenee dans les limites de celui-ci par une operation de reduction). Ce sont 
des structures permettant de rechercher rapidement des valeurs pour lesquelles une fonction 
de hachage simple existe. Cependant, elles se comportent moins bien que les arbres binaires 
lorsque le nombre d'elements augmente (quelques milliers). On leur preferera done generalement 
les associations de la bibliotheque standard, comme les map et multimap par exemple. Vous 
pouvez consulter la bibliographie si vous desirez obtenir plus de renseignements sur les tables 
de hachage et les structures de donnees en general. Les associations et les conteneurs de la 
bibliotheque standard seront decrites dans le Chapitre 17. 



16.2.4. Les facettes de gestion des nombres 

Les operations de formatage et les operations d'interpretation des donnees numeriques dependent bien 
entendu des conventions nationales de la locale incluse dans les flux qui effectuent ces operations. En 
realite, ces operations ne sont pas prises en charge directement par les flux, mais plutot par les facettes 
de gestion des nombres, qui regroupent toutes les operations propres aux conventions nationales. 

La bibliotheque standard definit en tout trois facettes qui interviennent dans les operations de 
formatage : une facette utilitaire, qui contient les parametres specifiques a la locale, et deux facettes 
dediees respectivement aux operations de lecture et aux operations d'ecriture des nombres. 

16.2.4.1. La facette num_punct 

La facette qui regroupe tous les parametres de la locale est la facette num_punct. Elle est declaree 
comme suit dans l'en-tete locale : 

template <class charT> 

class numpunct : public locale :: facet 
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public : 

// Les types de donnees : 

typedef charT char_type; 

typedef basic_string<charT> string_type; 

// Le constructeur : 

explicit numpunct (size_t refs = ) ; 

// Les methodes de lecture des options de formatage des nombres 
char_type decimal_point ( ) const; 
char_type thousands_sep ( ) const; 
string grouping () const; 
string_type truenameO const; 
string_type falsename() const; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



La methode decimal_point permet d'obtenir le caractere qui doit etre utilise pour separer le chiffre 
des unites des chiffres apres la virgule lors des operations de formatage des nombres a virgule. La 
valeur par defaut est le caractere ' . ', mais en France, le caractere utilise est la virgule (caractere ' , '). 
De meme, la methode thousands_sep permet de determiner le caractere qui est utilise pour separer 
les groupes de chiffres lors de l'ecriture des grands nombres. La valeur par defaut renvoyee par cette 
fonction est le caractere virgule (caractere ' , '), mais dans les locales francaises, on utilise generale- 
ment un espace (caractere ' '). Enfin, la methode grouping permet de determiner les emplacements 
ou ces separateurs doivent etre introduits. La chaine de caracteres renvoyee determine le nombre de 
chiffres de chaque groupe de chiffres. Le nombre de chiffres du premier groupe est ainsi stocke dans 
le premier caractere de la chaine de caracteres renvoyee par la methode grouping, celui du deuxieme 
groupe est stocke dans le deuxieme caractere, et ainsi de suite. Le dernier nombre ainsi obtenu dans 
cette chaine de caracteres est ensuite utilise pour tous les groupes de chiffres suivants, ce qui evite 
d' avoir a definir une chaine de caracteres arbitrairement longue. Un nombre de chiffres nul indique 
que le mecanisme de groupage des chiffres des grands nombres est desactive. Les facettes de la plu- 
part des locales renvoient la valeur " \ 3 " , ce qui permet de grouper les chiffres par paquets de trois 
(milliers, millions, milliards, etc.). 

Note : Remarquez que les valeurs stockees dans la chaine de caracteres renvoyee par la meth- 
ode grouping sont des valeurs numeriques et non des chiffres formates dans la chaine de car- 
acteres. Ainsi, la valeur par defaut renvoyee est bien "\03" et non "3". 



Les methodes truename et f alsename quant a elles permettent aux facettes de formatage d'obtenir 
les chaines de caracteres qui represented les valeurs true et false des booleens. Ce sont ces chaines 
de caracteres qui sont utilisees lorsque l'option de formatage boolalpha a ete activee dans les flux 
d' entree / sortie. Les valeurs retournees par ces methodes sont, par defaut, les mots anglais true et 
false. II est concevable dans d'autres locales, cependant, d'avoir des noms differents pour ces deux 
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valeurs. Nous verrons dans la Section 16.3.2 la maniere de proceder pour redefinir ces methodes et 
construire ainsi une locale personnalisee et francisee. 

Note : Bien entendu, les facettes d'ecriture et de lecture des nombres utilisent egalement les 
options de formatage qui sont definis au niveau des flux d'entree / sortie. Pour cela, les operations 
d'entree / sortie regoivent en parametre une reference sur le flux contenant ces options. 



16.2.4.2. La facette d'ecriture des nombres 

L'ecriture et le formatage des nombres sont pris en charge par la facette num_put. Cette facette est 
declaree comme suit dans l'en-tete locale : 

template <class charT, 

class Outputlterator = ostreambuf_iterator<charT> > 
class num_put : public locale :: facet 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef Outputlterator iter_type; 

// Le constructeur : 

explicit num_put ( size_t refs = 0); 

// Les methodes d'ecriture des nombres : 

iter_type put (iter_type s, ios_base &f , char_type remplissage, bool v) const; 
iter_type put (iter_type s, ios_base &f , char_type remplissage, long v) const; 
iter_type put (iter_type s, ios_base Sf , char_type remplissage, 

unsigned long v) const; 
iter_type put (iter_type s, ios_base Sf , char_type remplissage, 

double v) const; 
iter_type put (iter_type s, ios_base Sf , char_type remplissage, 

long double v) const; 
iter_type put (iter_type s, ios_base Sf , char_type remplissage, 

void *v) const; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



Comme vous pouvez le constater, cette facette dispose d'une surcharge de la methode put pour cha- 
cun des types de base du langage. Ces surcharges prennent en parametre un iterateur d'ecriture sur 
le flux de sortie sur lequel les donnees formatees devront etre ecrites, une reference sur le flux de 
sortie contenant les options de formatage a utiliser lors du formatage des nombres, le caractere de 
remplissage a utiliser, et bien entendu la valeur a ecrire. 
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En general, ces methodes sont appelees au sein des operateurs d'insertion operator<< pour chaque 
type de donnee existant. De plus, le flux de sortie sur lequel les ecritures doivent etre effectuees est 
le meme que le flux servant a specifier les options de formatage, si bien que l'appel aux methodes 
put est extremement simp rifle. Nous verrons plus en detail la maniere d'appeler ces methodes dans 
la Section 16.3.1, lorsque nous ecrirons une nouvelle facette pour un nouveau type de donnee. 



16.2.4.3. La facette de lecture des nombres 

Les operations de lecture des nombres a partir d'un flux de donnees sont prises en charge par la facette 
num_get. Cette facette est declaree comme suit dans l'en-tete locale : 

template <class charT, 

class Input Iterator = istreambuf_iterator<charT> > 
class num_get : public locale :: facet 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef Inputlterator iter_type; 

// Le constructeur : 

explicit num_get ( size_t refs = 0); 



// Les methodes de 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios_base : : 
iter_type get ( 

ios base : : 



lecture des nombres : 

iter_type in, iter_type end, ios_base & 

iostate Serr, bool &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, long &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, unsigned short &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, unsigned int &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, unsigned long &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, float Sv) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, double &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, long double &v) const; 

iter_type in, iter_type end, ios_base & 

iostate Serr, void *&v) const; 



// L' identif icateur de la facette 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 
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Comme vous pouvez le constater, cette facette ressemble beaucoup a la facette num_put. II existe 
en effet une surcharge de la methode get pour chaque type de base du langage. Ces methodes sont 
capables d'effectuer la lecture des donnees de ces types a partir du flux d' entree, en tenant compte 
des parametres des locales et des options de formatage du flux. Ces methodes prennent en parametre 
un iterateur de flux d' entree, une valeur limite de cet iterateur au-dela de laquelle la lecture du flux ne 
se fera pas, la reference sur le flux d'entree contenant les options de formatage et deux parametres de 
retour. Le premier parametre recevra un code d'erreur de type iostate qui pourra etre positionne dans 
le flux d'entree pour signaler l'erreur. Le deuxieme est une reference sur la variable devant accueillir 
la valeur lue. Si une erreur se produit, cette variable n'est pas modifiee. 

Les methodes get sont generalement utilisees par les operateurs d'extraction operator>> des flux 
d'entree / sortie pour les types de donnees de base du langage. En general, ces operateurs recuperent 
la locale incluse dans le flux d'entree sur lequel ils travaillent et utilisent la facette num_get de cette 
locale. Ils appellent alors la methode get permettant de lire la donnee qu'ils doivent extraire, en 
fournissant ce meme flux en parametre. Ils testent ensuite la variable d'etat retournee par la methode 
get et, si une erreur s'est produite, modifient l'etat du flux d'entree en consequence. Cette derniere 
operation peut bien entendu provoquer le lancement d'une exception, selon le masque d' exceptions 
utilise pour le flux. 



16.2.5. Les facettes de gestion des monnaies 

La bibliotheque standard ne definit pas de type de donnee dedies a la representation des montants. Elle 
suppose en effet que les montants sont stockes dans des nombres a virgule flottante dans la plupart 
des programmes ou, pour les programmes qui desirent s'affranchir des erreurs d'arrondis inevitables 
lors de 1' utilisation de flottants, sous forme textuelle dans des chaines de caracteres. En revanche, la 
bibliotheque standard fournit, tout comme pour les types standards, deux facettes localisees prenant 
en compte la lecture et l'ecriture des montants. Ces facettes se basent egalement sur une troisieme 
facette qui regroupe tous les parametres specifiques aux conventions nationales. 

Note : En realite, les seuls types capables de representer correctement les montants en infor- 
matique sont les entiers et les nombres a virgule fixe codes sur les entiers. En effet, les types 
integraux sont les seuls types qui ne soulevent pas de probleme de representation des nombres 
(a condition qu'il n'y ait pas de debordements bien entendu) et les nombres a virgule fixe sont 
particulierement adaptes aux montants, car en general le nombre de chiffres significatifs apres la 
virgule est fixe pour une monnaie donnee. Les nombres a virgule flottante ne permettent pas de 
representer des valeurs avec precision et introduisent des erreurs incontrolables dans les calculs 
et dans les arrondis. Les chaines de caracteres quant a elles souffrent de leur lourdeur et, dans 
la plupart des cas, de la necessite de passer par des nombres a virgule flottantes pour interpreter 
leur valeur. Les facettes presentees dans cette section sont done d'une utilite reduite pour les 
programmes qui cherchent a obtenir des resultats rigoureux et precis, et qui ne tolerent pas les 
erreurs de representation et les erreurs d'arrondis. 



Toutes les facettes de gestion des montants sont des classes template. Cependant, contrairement 
aux autres facettes, ces facettes disposent d'un autre parametre template que le type de caractere 
sur lequel elles travaillent. Ce parametre est un parametre de type booleen qui permet, selon sa valeur, 
de specifier si les facettes doivent travailler avec la representation internationale des montants ou non. 
II existe en effet une representation universelle des montants qui, entre autres particularites, utilise les 
codes internationaux de monnaie (« USD » pour le dollar americain, « CAN » pour le dollar canadien, 
« EUR » pour l'euro, etc.). 
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Comme pour les facettes de gestion des nombres, les facettes prenant en charge les monnaies sont 
au nombre de trois. Une de ces trois facettes permet d'obtenir des informations sur la monnaie de la 
locale et les deux autres realisent respectivement les operations d'ecriture et de lecture sur un flux. 

16.2.5.1. La facette money_punct 

La facette moneypunct est la facette permettant aux deux facettes d'ecriture et de lecture des montants 
d'obtenir les informations relatives a la monnaie de leur locale. Cette facette est declaree comme suit 
dans l'en-tete locale : 

template <class charT, bool International = false> 

class moneypunct : public locale :: facet , public money_base 

{ 

public : 

// Les types de donnees : 

typedef charT char_type; 

typedef basic_string<charT> string_type; 

// Le constructeur : 

explicit moneypunct ( size_t refs = 0); 

// Les methodes de lecture des options de formatage des montants : 
charT decimal_point ( ) const; 
charT thousands_sep ( ) const; 
string grouping () const; 
int f rac_digits ( ) const; 

string_type curr_symbol ( ) const; 
pattern pos_format() const; 
pattern neg_format() const; 
string_type positive_sign ( ) const; 
string_type negative_sign ( ) const; 
static const bool intl = International; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



Comme vous pouvez le constater, cette facette dispose de methodes permettant de recuperer les di- 
vers symboles qui sont utilises pour ecrire les montants de la monnaie qu'elle decrit. Ainsi, la methode 
decimal_point renvoie le caractere qui doit etre utilise en tant que separateur du chiffre des uni- 
tes de la partie fractionnaire des montants, si celle-ci doit etre representee. De meme, la methode 
thousands_sep renvoie le caractere qui doit etre utilise pour separer les groupes de chiffres pour 
les grands montants, et la methode grouping renvoie une chaine contenant, dans chacun de ses ca- 
racteres, le nombre de chiffres de chaque groupe. Ces methodes sont done semblables aux methodes 
correspondantes de la facette numpunct. Le nombre de chiffres significatifs apres la virgule utilise 
pour cette monnaie peut etre obtenue grace a la methode f rac_digits. Ce n'est que si la valeur 
renvoyee par cette methode est superieure a que le symbole de separation des unites de la partie 
fractionnaire de la methode decimal_point est utilise. 
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La methode curr_symbol permet d'obtenir le symbole monetaire de la monnaie. Ce symbole de- 
pend de la valeur du parametre template international. Si ce parametre vaut true, le symbole 
monetaire renvoye sera le symbole monetaire international. Dans le cas contraire, ce sera le symbole 
monetaire en usage dans le pays de circulation de la monnaie. La valeur du parametre internatio- 
nal pourra etre obtenu grace a la constante statique intl de la facette. 

Les methodes suivantes permettent de specifier le format d'ecriture des montants positifs et negatifs. 
Ces methodes utilisent les definitions de constantes et de types de la classe de base money _base dont 
la facette moneypunct herite. La classe money _base est declaree comme suit dans l'en-tete locale : 

class money_base 

{ 

public : 

enum part 

{ 

none, space, symbol, sign, value 

}; 

struct pattern 

{ 

char field[4] ; 
}; 
}; 



Cette classe contient la definition d'une enumeration dont les valeurs permettent d'identifier les dif- 
ferentes composantes d'un montant, ainsi qu'une structure pattern qui contient un tableau de quatre 
caracteres. Chacun de ces caracteres peut prendre l'une des valeurs de l'enumeration part. La structure 
pattern definit done l'ordre dans lequel les composantes d'un montant doivent apparaitre. Ce sont des 
motifs de ce genre qui sont renvoyes par les methodes pos_f ormat et neg_f ormat, qui permettent 
d'obtenir respectivement le format des montants positifs et celui des montants negatifs. 

Les differentes valeurs que peuvent prendre les elements du motif pattern represented chacune une 
partie de l'expression d'un montant. La valeur value represente bien entendu la valeur de ce montant, 
sign son signe et symbol le symbole monetaire. La valeur space permet d'inserer un espace dans 
l'expression d'un montant, mais les espaces ne peuvent pas etre utilises en debut et en fin de montants. 
Enfin, la valeur none permet de ne rien mettre a la position oil il apparait dans le motif. 

La maniere d'ecrire les montants positifs et negatifs varie grandement selon les pays. En general, 
il est courant d'utiliser le signe '-' pour signaler un montant negatif et aucun signe distinctif pour 
les montants positifs. Cependant, certains pays ecrivent les montants negatifs entre parentheses et la 
marque des montants negatifs n'est done plus un simple caractere. Les methodes positive_sign 
et negative_sign permettent d'obtenir les symboles a utiliser pour noter les montants positifs et 
negatifs. Elles retournent toutes les deux une chaine de caracteres, dont le premier est place systema- 
tiquement a 1' emplacement auquel la valeur sign a ete affectee dans la chaine de format renvoyee 
par les methodes pos_f ormat et neg_f ormat. Les caracteres residuels, s'ils existent, sont places a 
la fin de l'expression du montant completement formatee. Ainsi, dans les locales pour lesquelles les 
montants negatifs sont ecrits entre parentheses, la chaine renvoyee par la methode negative_sign 
est « ( ) », et pour les locales utilisant simplement le signe negatif, cette chaine ne contient que le 
caractere '-'. 



16.2.5.2. Les facettes de lecture et d'ecriture des montants 

Les facettes d'ecriture et de lecture des montants sont sans doute les facettes standards les plus 
simples. En effet, elles ne disposent que de methodes permettant d'ecrire et de lire les montants 
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sur les flux. Ces facettes sont respectivement les facettes money _put et money_get. Elles sont definies 
comme suit dans l'en-tete locale : 

template <class charT, bool Intl = false, 

class Outputlterator = ostreambuf_iterator<charT> > 
class money_put : public locale :: facet 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef Outputlterator iter_type; 

typedef basic_string<charT> string_type; 

// Le constructeur : 

explicit money_put (size_t refs = 0); 

// Les methodes d' ecriture des montants : 

iter_type put (iter_type s, bool intl, ios_base &f , 

char_type remplissage, long double units) const; 

iter_type put (iter_type s, bool intl, ios_base &f , 

char_type remplissage, const string_type Sdigits) const; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 

template <class charT, 

class Input Iterator = istreambuf_iterator<charT> > 
class money_get : public locale :: facet 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef Inputlterator iter_type; 

typedef basic_string<charT> string_type; 

// Le constructeur : 

explicit money_get (size_t refs = 0) ; 

// Les methodes de lecture des montants : 

iter_type get (iter_type s, iter_type end, bool intl, 

ios_base &f, ios_base : : iostate Serr, 

long double Sunits) const; 
iter_type get (iter_type s, iter_type end, bool intl, 

ios_base &f, ios_base :: iostate Serr, 

string_type Sdigits) const; 
static const bool intl = Intl; 

// L' identif icateur de la facette : 
static locale: : id id; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 
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Comme vous pouvez le constater, les methodes d'ecriture et de lecture put et get de ces facettes 
sont semblables aux methodes correspondantes des facettes de gestion des nombres. Toutefois, elles 
se distinguent par un parametre booleen complementaire qui permet d'indiquer si les operations de 
formatage doivent se faire en utilisant les conventions internationales d'ecriture des montants. Les 
autres parametres ont la meme signification que pour les methodes put et get des facettes de gestion 
des nombres. En particulier, l'iterateur fourni indique l'emplacement ou les donnees doivent etre 
ecrites ou lues, et le flux d' entree / sortie specifie permet de recuperer les options de formatage des 
montants. L'une des options les plus utiles est sans doute l'option qui permet d'afficher la base des 
nombres, car, dans le cas des facettes de gestion des montants, elle permet d'activer ou non l'ecriture 
du symbole monetaire. Enfin, les methodes put et get sont fournies en deux exemplaires, un pour 
chaque type de donnee utilisable pour representer les montants, a savoir les double et les chaines de 
caracteres. 



16.2.6. Les facettes de gestion du temps 

La bibliotheque standard ne fournit que deux facettes pour l'ecriture et la lecture des dates : la facette 
time_put et la facette time_get. Ces deux facettes utilisent le type de base struct tm de la bibliotheque 
C pour representer le temps. Bien que ce document ne decrive pas les fonctions de la bibliotheque C, 
il est peut-etre bon de rappeler comment les programmes C manipulent les dates en general. 

La gestion du temps dans un programme peut tres vite devenir un veritable cauchemar, principalement 
en raison de la complexite que les etres humains se sont efforces de developper dans leur maniere de 
representer le temps. En effet, il faut tenir compte non seulement des specificites des calendriers (an- 
nees bissextiles ou non par exemple), mais aussi des multiples bases de numeration utilisees dans 
l'ecriture des dates (24 heures par jour, 60 minutes par heure et 60 secondes par minutes, puis 10 
dixiemes dans une seconde et ainsi de suite) et des conventions locales de gestion des heures (fuseau 
horaire, heure d'ete et d'hiver). La regie d'or lors de la manipulation des dates est done de toujours 
travailler dans un referentiel unique avec une representation lineaire du temps, autrement dit, de sim- 
plifier tout cela. En pratique, cela revient a dire que les programmes doivent utiliser une representation 
lineaire du temps (generalement, le nombre de secondes ecoulees depuis une date de reference) et tra- 
vailler en temps universel. De meme, le stockage des dates doit etre fait dans ce format afin de garantir 
la possibilite d'echanger les donnees sans pour autant laisser la place aux erreurs d' interpretation de 
ces dates. 

En pratique, la bibliotheque C utilise le type time_t. Les valeurs de ce type representent le nombre 
d'instants ecoules depuis le premier Janvier 1970 a heure (date consideree comme le debut de l'ere 
informatique par les inventeurs du langage C, Kernighan et Ritchie, et que Ton appelle couramment 
« Epoch »). La duree de ces instants n'est pas normalisee par la bibliotheque C, mais il s'agit de 
secondes pour les systemes POSIX. Le type time_t permet done de realiser des calculs simplement 
sur les dates. Les dates representees avec des time_t sont toujours exprimees en temps universel. 

Bien entendu, il existe des fonctions permettant de convertir les dates codees sous la forme de time_t 
en dates humaines et reciproquement. Le type de donnee utilise pour stocker les dates au format 
humain est la structure struct tm. Cette structure contient plusieurs champs, qui representent entre 
autres l'annee, le jour, le mois, les heures, les minutes et les secondes. Ce type contient done les dates 
au format eclate et permet d'obtenir les differentes composantes d'une date. 

Generalement, les dates sont formatees en temps local, car les utilisateurs desirent souvent avoir les 
dates affichees dans leur propre base de temps. Cependant, il est egalement possible de formater les 
dates en temps universel. Ces operations de formatages sont realisees par les bibliotheques C et C++, 
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et les programmes n'ont done pas a se soucier des parametres de fuseaux horaires, d'heure d'ete et 
d'hiver et des conventions locales d'ecriture des dates : tout est pris en charge par les locales. 

Les principales fonctions permettant de manipuler les dates sont recapitulees dans le tableau ci- 
dessous : 

Tableau 16-1. Fonctions C de gestion des dates 



Fonction 


Description 


time_t time (time_t 
*) 


Permet d'obtenir la date courante. Peut etre appelee avec l'adresse d'une 
variable de type time_t en parametre ou avec la constante null. Initialise 
la variable passee par pointeur avec la date courante, et renvoie egalement 
la valeur ecrite. 


struct tm 
*gmtime (const 
time_t *) 


Permet de convertir une date stockee dans une variable de type time_t en 
sa version eclatee en temps universel. Le pointeur renvoye reference une 
structure allouee en zone statique par la bibliotheque C et ne doit pas etre 
libere. 


struct tm 
*localtime (const 
time_t *) 


Permet de convertir une date stockee dans une variable de type time_t en 
sa version eclatee en temps local. Le pointeur renvoye reference une 
structure allouee en zone statique par la bibliotheque C et ne doit pas etre 
libere. 


time_t 

mktime (struct tm 

*) 


Permet de construire une date de type time_t a partir d'une date en temps 
local stockee dans une structure struct tm. Les donnees membres de la 
structure struct tm peuvent etre corrigees par la fonction mkt ime si besoin 
est. Cette fonction est done la fonction inverse de localtime. 


size_t 

strftime (char 
*tampon, size_t 
max, const char 
*format, constr 
struct tm *t) 


Permet de formater une date stockee dans une structure struct tm dans une 
chaine de caracteres. Cette chaine doit etre fournie en premier parametre, 
ainsi que le nombre maximal de caracteres que la fonction pourra ecrire. 
La fonction renvoie le nombre de caracteres ecrits ou, si le premier 
parametre est nul, la taille de la chaine de caracteres qu'il faudrait pour 
effectuer une ecriture complete. La fonction strftime prend en 
parametre une chaine de format et fonctionne de maniere similaire aux 
fonctions print f et sprint f. Elle comprend un grand nombre de 
formats, mais les plus utiles sont sans doute les formats « %x » et « %x », 
qui permettent respectivement de formater l'heure et la date selon les 
conventions de la locale du programme. 



Note : II n'existe pas de fonction permettant de convertir une date exprimee en temps universel 
et stockee dans une structure struct tm en une date de type time_t. De meme, la bibliotheque 
C ne fournit pas de fonction permettant d'analyser une chaine de caracteres representant une 
date. Cependant, la norme Unix 98 definit la fonction strptime, qui est la fonction inverse de la 

fonction strftime. 

Les fonctions localtime et gmtime ne sont pas sures dans un environnement multithreade. En 
effet, la zone de memoire renvoyee est en zone statique et est partagee par tous les threads. 
La bibliotheque C definit done deux fonctions complementaires, iocaitime_r et gmtime_r, qui 
prennent un parametre complementaire qui doit recevoir un pointeur sur la structure struct tm 
dans lequel le resultat doit etre ecrit. Cette structure est allouee par le thread appelant et ne 
risque done pas d'etre detruite par un appel a la meme fonction par un autre thread. 

Les facettes de la bibliotheque standard C++ ne permettent pas de manipuler les dates en soi. 
Elles ne sont destinees qu'a realiser le formatage des dates en tenant compte des specificites 
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de representation des dates de la locale. Elles se comportent exactement comme la fonction 
strftime le fait lorsque Ton utilise les chaines de format « %x » et « %x ». 



16.2.6.1. La facette d'ecriture des dates 

La facette d'ecriture des dates est declaree comme suit dans l'en-tete locale : 

template <class charT, 

class Outputlterator = ostreambuf_iterator<charT> > 
class time_put : public locale :: facet 
{ 

public : 
// Les types de donnees : 

typedef charT char_type; 

typedef Outputlterator iter_type; 

// Le constructeur : 

explicit time_put (size_t refs = 0); 

// Les methodes d'ecriture des dates : 

iter_type put (iter_type s, ios_base Sf, char_type remplissage, const tm *t, 

char format, char modificateur = 0) const; 
iter_type put (iter_type s, ios_base Sf, char_type remplissage, const tm *t, 

const charT *debut_f ormat , const charT *fin_format) const; 

// L' identif icateur de la facette : 

static locale: :id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



Cette facette dispose de deux surcharges de la methode put permettant d'ecrire une date sur un flux de 
sortie. La premiere permet d'ecrire une date sur le flux de sortie dont un iterateur est donne en premier 
parametre. Le formatage de la date se fait comme avec la fonction strftime de la bibliotheque C. 
Le parametre modificateur ne doit pas etre utilise en general, sa signification n'etant pas precisee 
par la norme C++. La deuxieme forme de la methode put realise egalement une ecriture sur le flux, 
en prenant comme chaine de format la premiere sous-chaine commencant par le caractere '%' dans la 
chaine indiquee par les parametres debut_f ormat et fin_f ormat. 



16.2.6.2. La facette de lecture des dates 

La facette de lecture des dates permet de lire les dates dans le meme format que celui utilise par la 
fonction strftime de la bibliotheque C lorsque la chaine de format vaut « %x » ou « %x ». Cette 
facette est declaree comme suit dans l'en-tete locale : 

template <class charT, 

class Input Iterator = istreambuf_iterator<charT> > 
class time_get : public locale :: facet, public time_base 
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public : 

// Les types de donnees : 

typedef charT char_type; 

typedef Inputlterator iter_type; 

// Le constructeur : 

explicit time_get (size_t refs = 0); 

// Les methodes de gestion de la lecture des dates : 

iter_type get_time (iter_type s, iter_type end, ios_base &f, 

ios_base : : iostate Serr, tm *t) const; 
iter_type get_date (iter_type s, iter_type end, ios_base &f, 

ios_base :: iostate Serr, tm *t) const; 
iter_type get_weekday (iter_type s, iter_type end, ios_base &f, 

ios_base :: iostate Serr, tm *t) const; 
iter_type get_monthname (iter_type s, iter_type end, ios_base &f, 

ios_base :: iostate Serr, tm *t) const; 
iter_type get_year (iter_type s, iter_type end, ios_base &f, 

ios_base :: iostate Serr, tm *t) const; 
dateorder date_order() const; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



Les differentes methodes de cette facette permettent respectivement d'obtenir l'heure, la date, le jour 
de la semaine, le nom du mois et l'annee d'une date dans le flux d'entree specifie par l'iterateur 
fourni en premier parametre. Toutes ces donnees sont interpreters en fonction de la locale a laquelle 
la facette appartient. 

Enfin, la methode date_order permet d'obtenir l'une des valeurs de l'enumeration definie dans la 
classe de base time_base et qui indique l'ordre dans lequel les composants jour / mois / annee des 
dates apparaissent dans la locale de la facette. La classe de base time_base est declaree comme suit 
dans l'en-tete locale : 

class time_base 

{ 

public : 

enum dateorder 

{ 

no_order, dmy, mdy, ymd, ydm 

}; 
}; 



La signification des differentes valeurs de l'enumeration est immediate. La seule valeur necessitant 
des explications complementaires est la valeur no_order. Cette valeur est renvoyee par la methode 
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date_order si le format de date utilise par la locale de la facette contient d'autres champs que le 
jour, le mois et l'annee. 

Note : La methode date_order est fournie uniquement a titre de facilite par la bibliotheque stan- 
dard. Elle peut ne pas etre implementee pour certaines locales. Dans ce cas, elle renvoie syste- 
matiquement la valeur no_order. 



16.2.7. Les facettes de gestion des messages 

Afin de faciliter l'internationalisation des programmes, la bibliotheque standard fournit la facette mes- 
sages, qui permet de prendre en charge la traduction de tous les messages d'un programme de maniere 
independante du systeme sous-jacent. Cette facette permet d'externaliser tous les messages des pro- 
grammes dans des fichiers de messages que Ton appelle des catalogues. Le format et l'emplacement 
de ces fichiers ne sont pas specifies par la norme C++, cependant, la maniere d'y acceder est standar- 
dised et permet d'ecrire des programmes portables. Ainsi, lorsqu'un programme devra etre traduit, il 
suffira de traduire les messages stockes dans les fichiers de catalogue pour chaque langue et de les 
distribuer avec le programme. 

Note : La maniere de creer et d'installer ces fichiers etant specifique a chaque implementation de 
la bibliotheque standard et, dans une large mesure, specifique au systeme d'exploitation utilise, 
ces fichiers ne seront pas decrits ici. Seule la maniere d'utiliser la facette messages sera done 
indiquee. Reportez-vous a la documentation de votre environnement de developpement pour plus 
de details sur les outils permettant de generer les fichiers de catalogue. 



La facette messages reference les fichiers de catalogue a l'aide d'un type de donnee specifique. Ce 
type de donnee est defini dans la classe de base messages_base comme etant un type integral : 

class messages_base 

{ 

public : 

typedef int catalog; 



La classe template messages de gestion de la facette herite done de cette classe de base et utilise le 
type catalog pour identifier les fichiers de catalogue de 1' application. 

La classe messages est declaree comme suit dans l'en-tete locale : 

template <class charT> 

class messages : public locale :: facet , public messages_base 

{ 

public : 

// Les types de donnees : 

typedef charT char_type; 

typedef basic_string<charT> string_type; 

// Le constructeur : 

explicit messages (size_t refs = 0); 

// Les methodes de gestion des catalogues de messages : 

catalog open (const basic_string<char> Snoro, const locale &1) const; 
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void close (catalog c) const; 

string_type get (catalog c, int groupe, int msg, 
const string_type Sdefaut) const ; 

// L' identif icateur de la facette : 

static locale: : id id; 
}; 



Note : Les methodes virtuelles d'implementation des methodes publiques n'ont pas ete ecrites 
dans la declaration precedente par souci de simplification. Elles existent malgre tout, et peuvent 
etre redefinies par les classes derivees afin de personnaliser le comportement de la facette. 



Les principales methodes de gestion des catalogues sont les methodes open et close. Comme leurs 
noms l'indiquent, ces methodes permettent d'ouvrir un nouveau fichier de catalogue et de le fermer 
pour en liberer les ressources. La methode open prend en parametre le nom du catalogue a ouvrir. Ce 
nom doit identifier de maniere unique le catalogue, mais la norme C++ n'indique pas comment il doit 
etre interprets. Cela releve done de 1' implementation de la bibliotheque standard utilisee. Toutefois, 
en pratique, il est probable qu'il s'agit d'un nom de fichier. Le deuxieme parametre permet d'indiquer 
la locale a utiliser pour effectuer les conversions de jeux de caracteres si cela est necessaire. II permet 
done de laisser au programmeur le choix du jeu de caracteres dans lequel les messages seront ecrits 
dans le catalogue. La valeur renvoyee par la methode open est l'identifiant du catalogue, identifiant 
qui devra etre fourni a la methode get pour recuperer les messages du catalogue et a la methode 
close pour fermer le fichier de catalogue. Si l'ouverture du fichier n'a pas pu etre effectuee, la 
methode open renvoie une valeur inferieure a 0. 

Les messages du catalogue peuvent etre recuperes a l'aide de la methode get. Cette methode prend en 
parametre l'identifiant d'un catalogue precedemment obtenu par 1' intermediate de la methode open, 
un identifiant de groupe de message et un identifiant d'un message. Le dernier parametre doit recevoir 
la valeur par defaut du message en cas d'echec de la recherche du message dans le catalogue. Cette 
valeur par defaut est souvent un message en anglais, ce qui permet au programme de fonctionner 
correctement meme lorsque ses fichiers de catalogue sont vides. 

La maniere dont les messages sont identifies n'est pas specifiee par la norme C++, tout comme la 
maniere dont ils sont classes en groupes de messages au sein d'un meme fichier de catalogue. Cela 
releve done de 1' implementation de la bibliotheque utilisee. Consultez la documentation de votre 
environnement de developpement pour plus de details a ce sujet. 

Note : Cette facette est relativement peu utilisee, pour plusieurs raison. Premierement, peu 
d'environnements C++ respectent la norme C++ a ce jour. Deuxiemement, les systemes 
d'exploitation disposent souvent de mecanismes de localisation performants et pratiques. Enfin, 
I'identification d'un message par des valeurs numeriques n'est pas toujours pratique et il est 
courant d'utiliser le message par defaut, souvent en anglais, comme clef de recherche pour 
les messages internationaux. Cette maniere de proceder est en effet beaucoup plus simple, 
puisque le contenu des messages est ecrit en clair dans la langue par defaut dans les fichiers 
sources du programme. 
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16.3. Personnalisation des mecanismes de localisation 

Les mecanismes de localisation ont ete concus de telle sorte que le programmeur peut, s'il le desire (et 
s'il en a reellement le besoin), personnaliser leur fonctionnement. Ainsi, il est parfaitement possible 
de definir de nouvelles facettes, par exemple pour permettre la localisation des types de donnees com- 
plementaires dermis par le programme. De meme, il est possible de redefinir les methodes virtuelles 
des classes de gestion des facettes standards de la bibliotheque et de remplacer les facettes originales 
par des facettes personnalisees. Cependant, il faut bien reconnaitre que la maniere de proceder n'est 
pas tres pratique, et en fait les mecanismes internes de gestion des facettes semblent etre reserves aux 
classes et aux methodes de la bibliotheque standard elle-meme. 

16.3.1. Creation et integration d'une nouvelle facette 

Comme il Fa ete explique dans la Section 16.1, une facette n'est rien d'autre qu'une classe derivant de 
la classe locale: :facet et contenant une donnee membre statique id. Cette donnee membre est utilisee 
par les classes de locale pour identifier le type de la facette et pour l'integrer dans le mecanisme de 
gestion des facettes standards. 

L' exemple suivant montre comment on peut realiser deux facettes permettant d'encapsuler les specifi- 
cites d'un type de donnee defini par le programme, le type answer_t. Ce type est suppose permettre la 
creation de variables contenant la reponse de l'utilisateur a une question. Ce n'est rien d'autre qu'une 
enumeration contenant les valeurs no (pour la reponse negative), yes (pour 1' affirmative), all (pour 
repondre par l'affirmative pour tout un ensemble d'elements) et none (pour repondre par la negative 
pour tout un ensemble d'elements). 

Dans cet exemple, deux facettes sont definies : la facette answerpunct, qui prend en charge la lo- 
calisation des noms des differentes valeurs de remuneration answer_t, et la facette answer_put, qui 
prend en charge le formatage des valeurs de cette enumeration dans un flux standard. L'operateur 
operator<< est egalement defini, afin de presenter la maniere dont ces facettes peuvent etre utili- 
sees. La facette answer_get et l'operateur correspondant operator» n'ont pas ete definis et sont 
laisses en exercice pour le lecteur interesse. 

Exemple 16-6. Definition de nouvelles facettes 

#include <iostream> 
#include <locale> 

using namespace std; 

// Nouveau type de donnee permettant de gerer les reponses 
// aux questions (yes / no / all / none) : 
enum answer_t 
{ 

no, yes, all, none 
}; 

// Facette prenant definissant les noms des reponses : 

template <class charT> 

class answerpunct : public locale :: facet 

{ 

public : 

// Les types de donnees : 

typedef charT char_type; 

typedef basic_string<charT> string_type; 
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II L' i dent if iant de la facette : 
static locale: : id id; 

// Le constructeur : 

answerpunct (size_t refs = 0) : locale :: facet (refs ) 

{ 

} 

// Les methodes permettant d'obtenir les noms des valeurs 

string_type yesnameO const 

{ 

return do_yesname ( ) ; 
} 

string_type nonameO const 
{ 

return do_noname () ; 
} 

string_type allnameO const 
{ 

return do_allname ( ) ; 
} 

string_type nonename ( ) const 
{ 

return do_nonename () ; 
} 

protected: 

// Le destructeur : 
virtual -answerpunct ( ) 
{ 
} 

// Les methodes virtuelles : 

virtual string_type do_yesname() const 

{ 

return "yes"; 
} 

virtual string_type do_noname() const 
{ 

return "no"; 
} 

virtual string_type do_allname() const 
{ 

return "all"; 
} 

virtual string_type do_nonename ( ) const 
{ 

return "none"; 
} 

}; 
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II Instanciation de 1' i dent if iant de la facette answerpunct : 

template <class charT> 

locale: : id answerpunct<charT> : : id; 

// Facette prenant en charge le formatage des reponses : 
template <class charT, 

class Outputlterator = ostreambuf_iterator<charT> > 
class answer_put : public locale :: facet 
public : 

// Les types de donnees : 

typedef charT char_type; 

typedef Outputlterator iter_type; 

typedef basic_string<charT> string_type; 

// L' identif iant de la facette : 
static locale: : id id; 

// Le constructeur : 

answer_put (size_t refs = 0) : locale :: facet (refs) 

{ 

} 

// La methode de formatage publique : 

iter_type put (iter_type i, ios_base Sflux, 

char_type remplissage, answer_t valeur) const 
{ 

return do_put(i, flux, remplissage, valeur); 
} 

protected: 

// Le destructeur : 
virtual ~answer_put ( ) 
{ 
} 

// L' implementation de la methode de formatage : 
virtual iter_type do_put (iter_type i, ios_base Sflux, 

char_type remplissage, answer_t valeur) const 
{ 

// Recupere la facette decrivant les noms de types : 
const answerpunct<charT> sfacet = 

use_f acet<answerpunct<charT> > (flux.getloc () ) ; 
// Recuperation du nom qui sera ecrit : 
string_type result; 
switch (valeur) 
{ 
case yes: 

result = f acet .yesname ( ) ; 

break; 
case no : 

result = f acet .noname ( ) ; 

break; 
case all: 

result = facet . allname () ; 

break; 
case none: 

result = f acet . nonename ( ) ; 
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break; 



} 

// Ecriture de la valeur : 

const char *p = result . c_str () ; 

while (*p != 0) 

{ 

*i = *p; 

++i; ++p; 
} 
return i; 



} 



}; 



// Instanciation de 1' identif iant de la facette answer_put 
template <class charT, 

class Outputlterator = ostreambuf_iterator<charT> > 
locale :: id answer_put<charT, Outputlterator> : : id; 

// Operateur permettant de formater une valeur 
// de type answer_t dans un flux de sortie : 
template <class charT, class Traits> 
basic_ostream<charT, Traits> &operator<< ( 

basic_ostream<charT, Traits> Sflux, 

answer_t valeur) 



{ 



// Initialisation du flux de sortie : 

typename basic_ostream<charT, Traits> :: sentry init(flux) 

if (init) 

{ 

// Recuperation de la facette de gestion de ce type : 

const answer_put<charT> sfacet = 

use_f acet<answer_put<charT> > (flux.getloc () ) ; 

// Ecriture des donnees : 

f acet . put ( flux, flux, ' ', valeur); 
} 
return flux; 



int main (void) 
{ 

// Cree une nouvelle locale utilisant nos deux facettes 

locale temp (locale ("") , new answerpunct<char>) ; 

locale loc (temp, new answer_put<char>) ; 

// Installe cette locale dans le flux de sortie : 

cout . imbue (loc) ; 

// Affiche quelques valeurs de type answer_t : 

cout << yes << endl; 

cout << no << endl; 

cout << all << endl; 

cout << none << endl; 

return ; 



} 



Note : Cet exemple, bien que deja complique, passe sous silence un certain nombre de points 
qu'il faudrait theoriquement prendre en compte pour realiser une implementation correcte des 
facettes et des operateurs d'insertion et d'extraction des donnees de type answer_t dans les flux 
standards. II faudrait en effet traiter les cas d'erreurs lors des ecritures sur le flux de sortie dans la 
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methode do_put de la facette answer_put, capter les exceptions qui peuvent se produire, corriger 
I'etat du flux d'entree / sortie au sein de I'operateur operator<< et relancer ces exceptions. 

De meme, les parametres de la locale ne sont absolument pas pris en compte dans la facette 
answerpunct, alors qu'une implementation complete devrait s'en soucier. Pour cela, il faudrait 
recuperer le nom de la locale incluse dans les flux d'entree / sortie d'une part, et definir une facette 
specialises answerpunct_byname, en fonction du nom de laquelle les methodes do_yesname, 
do_noname, do_aiiname et do_nonename devraient s'adapter. La section suivante donne un ex- 
emple de redefinition d'une facette existante. 



16.3.2. Remplacement d'une facette existante 

La redefinition des methodes de facettes deja existantes est legerement plus simple que l'ecriture 
d'une nouvelle facette. En effet, il n'est plus necessaire de definir la donnee membre statique id. De 
plus, seules les methodes qui doivent reellement etre redefinies doivent etre recrites. 

L'exemple suivant presente comment un programme peut redefinir les methodes do_truename et 
do_f alsename de la facette standard numpunct_byname afin d'en fournir une version localisee en 
francais. Cela permet d'utiliser ces noms francais dans les operations de formatage des flux d'entree 
/ sortie standards, lorsque le manipulateur boolalpha a ete utilise. 

Exemple 16-7. Specialisation d'une facette existante 

#include <iostream> 
#include <locale> 
#include <clocale> 
#include <cstring> 

using namespace std; 

// Facette destinee a remplacer numpunct_byname : 
class MyNumpunct_byname : 

public numpunct_byname<char> 
{ 

// Les noms des valeurs true et false : 

const char *m_truename; 

const char *m_f alsename; 

public : 

MyNumpunct_byname (const char* nom) : 

numpunct_byname<char> (nom) 
{ 

// Determine le nom de la locale active : 
const char *loc = nom; 
if (strcmp(nom, "") == 0) 
{ 

// Recupere le nom de la locale globale active : 
loc = setlocale(0, NULL) ; 
} 

// Prend en charge les noms frangais : 
if (strcmp (loc, "fr_FR") == 0) 
{ 

m_truename = "vrai"; 
m_falsename = "faux"; 
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! 



else 



// Pour les autres locales, utilise les noms anglais 
m_truename = "true"; 
m_f alsename = "false"; 



} 



protected: 

~MyNumpunct_byname ( ) 



string olo_truename ( ) const 
return m_truename; 

string do_f alsename ( ) const 
return m_f alsename; 



}; 



int main (void) 
{ 

// Fixe la locale globale du programme : 

locale: :global (locale ("") ) ; 

// Cree une nouvelle locale utilisant notre facette 
locale 1 (locale ("") , new MyNumpunct_byname ( " " ) ) ; 

// Installe cette locale dans le flux de sortie : 

cout . imbue (1) ; 

// Affiche deux booleens : 

cout << boolalpha << true << endl; 

cout << false << endl; 

return 0; 



Note : La classe de base de la facette MyNumpunct_byname est la classe num P unct_byname 
parce que la facette a besoin de connaitre le nom de la locale pour laquelle elle est construite. 
En effet, aucun autre mecanisme standard ne permet a une facette de recuperer ce nom et done 
de s'adapter aux differentes locales existantes. Vous remarquerez que les facettes de formatage 
n'ont pas besoin de connaitre ce nom puisqu'elles peuvent le recuperer grace a la methode name 
de la locale du flux sur lequel elles travaillent. 

La facette MyNumpunct_byname utilise la fonction setiocaie de la bibliotheque C pour recuperer 
le nom de la locale courante si elle est initialiser avec un nom vide. En realite, elle devrait 
recuperer ce nom par ses propres moyens et effectuer les traductions des noms des valeurs 
true et false par elle-meme, car cela suppose que la locale globale du programme est initial- 
isee avec le meme nom. C'est pour cela que le programme principal commence par appeler la 
methode global de la classe local avec comme parametre une locale anonmyme. Cela dit, les 
mecanismes permettant a un programme de recuperer les parametres de la locale definie dans 
I'environnement d'execution du programme sont specifiques a chaque systeme et ne peuvent 
done pas etre decrits ici. 
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Bien entendu, si d'autres langues que le frangais devaient etre prises en compte, d'autre mecan- 
ismes plus generiques devraient egalement etre mis en place pour definir les noms des valeurs 
true et false afin d'eviter de compliquer exagerement le code de la facette. 
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La plupart des programmes informatiques doivent, a un moment donne ou a un autre, conserver un 
nombre arbitraire de donnees en memoire, generalement pour y acceder ulterieurement et leur appli- 
quer des traitements specifiques. En general, les structures de donnees utilisees sont toujours mani- 
pulees par des algorithmes classiques, que Ton retrouve done souvent, si ce n'est plusieurs fois, dans 
chaque programme. Ces structures de donnees sont communement appelees des conteneurs en raison 
de leur capacite a contenir d'autres objets. 

Afin d'eviter aux programmeurs de reinventer systematiquement la roue et de reprogrammer les struc- 
tures de donnees et leurs algorithmes associes les plus classiques, la bibliotheque standard definit un 
certain nombre de classes template pour les conteneurs les plus courants. Ces classes sont parame- 
trees par le type des donnees des conteneurs et peuvent done etre utilisees virtuellement pour toutes 
les situations qui se presentent. 

Les conteneurs de la bibliotheque standard ne sont pas definis par les algorithmes qu'ils utilisent, 
mais plutot par l'interface qui peut etre utilisee par les programmes clients. La bibliotheque standard 
impose egalement des contraintes de performances sur ces interfaces en termes de complexite. En 
realite, ces contraintes sont tout simplement les plus fortes qui soient, ce qui garantit aux programmes 
qui les utilisent qu'ils auront les meilleures performances possibles. 

La bibliotheque classifie les conteneurs en deux grandes categories selon leurs fonctionnalites : les se- 
quences et les conteneurs associatifs. Une sequence est un conteneur capable de stocker ses elements 
de maniere sequentielle, les uns a la suite des autres. Les elements sont done parfaitement identifies 
par leur position dans la sequence, et leur ordre relatif est done important. Les conteneurs associatifs, 
en revanche, manipulent leurs donnees au moyen de valeurs qui les identifient indirectement. Ces 
identifiants sont appelees des clefs par analogie avec la terminologie utilisee dans les bases de don- 
nees. L' ordre relatif des elements dans le conteneur est laisse dans ce cas a la libre discretion de ce 
dernier et leur recherche se fait done, generalement, par 1' intermediate de leurs clefs. 

La bibliotheque fournit plusieurs conteneurs de chaque type. Chacun a ses avantages et ses inconve- 
nients. Comme il n'existe pas de structure de donnees parfaite qui permette d'obtenir les meilleures 
performances sur l'ensemble des operations realisables, l'utilisateur des conteneurs de la bibliotheque 
standard devra effectuer son choix en fonction de 1' utilisation qu'il desire en faire. Par exemple, cer- 
tains conteneurs sont plus adaptes a la recherche d' elements mais sont relativement couteux pour 
les operations d'insertion ou de suppression, alors que pour d'autres conteneurs, e'est exactement 
l'inverse. Le choix des conteneurs a utiliser sera done determinant quant aux performances finales des 
programmes. 



17.1. Fonctionnalites generates des conteneurs 



Au niveau de leurs interfaces, tous les conteneurs de la bibliotheque standard presentent des simi- 
litudes. Cet etat de fait n'est pas du au hasard, mais bel et bien a la volonte de simplifier la vie 
des programmeurs en evitant de definir une multitude de methodes ayant la meme signification pour 
chaque conteneur. Cependant, malgre cette volonte d'uniformisation, il existe des differences entre les 
differents types de conteneurs (sequences ou conteneurs associatifs). Ces differences proviennent es- 
sentiellement de la presence d'une clef dans ces derniers, qui permet de manipuler les objets contenus 
plus facilement. 

Quelle que soit leur nature, les conteneurs fournissent un certain nombre de services de base que le 
programmeur peut utiliser. Ces services comprennent la definition des iterateurs, de quelques types 
complementaires, des operateurs et de fonctions standards. Les sections suivantes vous presentent ces 
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fonctionnalites generates. Toutefois, les descriptions donnees ici ne serontpas detaillees outre mesure 
car elles seront reprises en detail dans la description de chaque conteneur. 

17.1.1. Definition des iterateurs 

Pour commencer, il va de soi que tous les conteneurs de la bibliotheque standard disposent 
d'iterateurs. Comme on l'a vu dans la Section 13.4, les iterateurs constituent une abstraction 
de la notion de pointeur pour les tableaux. lis permettent done de parcourir tous les elements 
d'un conteneur sequentiellement a l'aide de l'operateur de dereferencement * et de l'operateur 
d' incrementation ++. 

Les conteneurs definissent done tous un type iterator et un type const_iterator, qui sont les types des 
iterateurs sur les elements du conteneur. Le type d' iterateur const_iterator est defini pour acceder 
aux elements d'un conteneur en les considerant comme des constantes. Ainsi, si le type des elements 
stockes dans le conteneur est T, le dereferencement d' un const_iterator renverra un objet de type const 
T. 

Les conteneurs definissent egalement les types de donnees difference_type et size_type que 1'on peut 
utiliser pour effectuer des calculs d'arithmetique des pointeurs avec leurs iterateurs. Le type diffe- 
rence_type se distingue du type size_type par le fait qu'il peut contenir toute valeur issue de la dif- 
ference entre deux iterateurs, et accepte done les valeurs negatives. Le type size_type quant a lui est 
utilise plus specialement pour compter un nombre d' elements, et ne peut prendre que des valeurs 
positives. 

Afin de permettre 1' initialisation de leurs iterateurs, les conteneurs fournissent deux methodes begin 
et end, qui renvoient respectivement un iterateur referencant le premier element du conteneur et la 
valeur de fin de l'iterateur, lorsqu'il a passe le dernier element du conteneur. Ainsi, le parcours d'un 
conteneur se fait typiquement de la maniere suivante : 

// Obtient un iterateur sur le premier element : 

Conteneur :: iterateur i = instance .begin () ; 

// Boucle sur toutes les valeurs de l'iterateur 

// jusqu' a la derniere : 

while (i != instance . end () ) 

{ 

// Travaille sur 1' element reference par i : 

f (*i) ; 

// Passe a 1' element suivant : 

+ + i; 
} 

ou Conteneur est la classe de du conteneur et instance en est une instance. 

Note : Pour des raisons de performances et de portabilite, la bibliotheque standard ne fournit 
absolument aucun support du multithreading sur ses structures de donnees. En fait, la gestion du 
multithreading est laissee a la discretion de chaque implementation. Generalement, seul le code 
genere par le compilateur est sur vis-a-vis des threads (en particulier, les operateurs d'allocation 
memoire new et new[], ainsi que les operateurs delete et delete n peuvent etre appeles si- 
multanement par plusieurs threads pour des objets differents). II n'en est pas de meme pour les 
implementations des conteneurs et des algorithmes de la bibliotheque standard. 

Par consequent, si vous voulez acceder a un conteneur a partir de plusieurs threads, vous de- 
vez prendre en charge vous-meme la gestion des sections critiques afin de vous assurer que ce 
conteneur sera toujours dans un etat coherent. En fait, il est recommande de le faire meme si 
('implementation de la bibliotheque standard se protege elle-meme contre les acces concurrents 
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a partir de plusieurs threads, afin de rendre vos programmes portables vers d'autres environ- 
nements. 



Les iterateurs utilises par les conteneurs sont tous au moins du type Forwardlterator. En pratique, 
cela signifie que Ton peut parcourir les iterateurs du premier au dernier element, sequentiellement. 
Cependant, la plupart des conteneurs disposent d' iterateurs au moins bidirectionnels, et peuvent done 
etre parcourus dans les deux sens. Les conteneurs qui disposent de ces proprietes sont appeles des 
conteneurs reversibles. 

Les conteneurs reversibles disposent, en plus des iterateurs directs, d'iterateurs inverses. Ces iterateurs 
sont repectivement de type reverse_iterator et const_reverse_iterator. Leur initialisation peut etre rea- 
lisee a l'aide de la fonction rbegin, et leur valeur de fin peut etre recuperee a l'aide de la fonction 

rend. 



17.1.2. Definition des types de donnees relatifs aux objets contenus 

Outre les types d'iterateurs, les conteneurs definissent egalement des types specifiques aux donnees 
qu'ils contiennent. Ces types de donnees permettent de manipuler les donnees des conteneurs de 
maniere generique, sans avoir de connaissance precises sur la nature reelle des objets qu'ils stockent. 
lis sont done couramment utilises par les algorithmes de la bibliotheque standard. 

Le type reellement utilise pour stocker les objets dans un conteneur n'est pas toujours le type tem- 
plate utilise pour instancier ce conteneur. En effet, certains conteneurs associatifs stockent les clefs 
des objets avec la valeur des objets eux-memes. lis utilisent pour cela la classe pair, qui permet de 
stocker, comme on l'a vu en Section 14.2.2, des couples de valeurs. Le type des donnees stockees par 
ces conteneurs est done plus complexe que le simple type template par lequel ils sont parametres. 

Afin de permettre l'uniformisation des algorithmes travaillant sur ces types de donnees, les conteneurs 
definissent tous le type value_type dans leur classe template. C'est en particulier ce type qu'il 
faut utiliser lors des insertions d'elements dans les conteneurs. Bien entendu, pour la plupart des 
conteneurs, et pour toutes les sequences, le type value_type est effectivement le meme type que le 
type template par lequel les conteneurs sont parametres. 

Les conteneurs definissent egalement d'autres types permettant de manipuler les donnees qu'ils 
stockent. En particulier, le type reference est le type des references sur les donnees, et le type 
const_reference est le type des references constantes sur les donnees. Ces types sont utilises par les 
methodes des conteneurs qui permettent d'acceder a leurs donnees. 



17.1.3. Specification de I'allocateur memoire a utiliser 

Toutes les classes template des conteneurs de la bibliotheque standard utilisent la notion d'allocateur 
pour realiser les operations de manipulation de la memoire qu'elles doivent effectuer lors du stockage 
de leurs elements ou lors de 1' application d' algorithmes specifiques au conteneur. Le type des allo- 
cateurs peut etre specifie dans la liste des parametres template des conteneurs, en marge du type 
des donnees contenues. Les constructeurs des conteneurs prennent tous un parametre de ce type, qui 
sera I'allocateur memoire utilise pour ce conteneur. Ainsi, il est possible de specifier un allocateur 
specifique pour chaque conteneur, qui peut etre particulierement optimise pour le type des donnees 
gerees par ce conteneur. 

Toutefois, le parametre template specifiant la classe de I'allocateur memoire a utiliser dispose d'une 
valeur par defaut, qui represente I'allocateur standard de la bibliotheque allocator<T>. II n'est done 
pas necessaire de specifier cet allocateur lors de l'instanciation d'un conteneur. Cela rend plus simple 
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1' utilisation de la bibliotheque standard C++ pour ceux qui ne desirent pas developper eux-meme un 
allocateur memoire. Par exemple, la declaration template du conteneur list est la suivante : 

template <class T, class Allocator = allocator<T> > 

II est done possible d'instancier une liste d'entiers simplement en ne specifiant que le type des objets 
contenus, en 1' occurrence, des entiers : 

typedef list<int> liste_entier; 



De meme, le parametre des constructeurs permettant de specifier 1' allocateur a utiliser pour les conte- 
neurs dispose systematiquement d'une valeur par defaut, qui est 1' instance vide du type d' allocateur 
specifie dans la liste des parametres template. Par exemple, la declaration du constructeur le plus 
simple de la classe list est la suivante : 

template <class T, class Allocator> 

list<T, Allocator>: :list (const Allocator & = Allocator ()) ; 

II est done parfaitement legal de declarer une liste d'entier simplement de la maniere suivante : 

liste_entier li; 



Note : II est peut-etre bon de rappeler que toutes les instances d'un allocateur accedent a la 
meme memoire. Ainsi, il n'est pas necessaire, en general, de preciser I'instance de I'allocateur 
dans le constructeur des conteneurs. En effet, le parametre par defaut fourni par la bibliotheque 
standard n'est qu'une instance parmi d'autres qui permet d'acceder a la memoire geree par la 
classe de I'allocateur fournie dans la liste des parametres template. 



Si vous desirez specifier une classe d'allocateur differente de celle de I'allocateur standard, vous 
devrez faire en sorte que cette classe implemente toutes les methodes des allocateurs de la bibliotheque 
standard. La notion d'allocateur a ete detaillee dans la Section 13.6. 



17.1.4. Operateurs de comparaison des conteneurs 

Les conteneurs disposent d' operateurs de comparaison permettant d'etablir des relations 
d' equivalence ou des relations d'ordre entre eux. 

Les conteneurs peuvent tous etre compares directement avec les operateurs == et ! =. La relation 
d'egalite entre deux conteneurs est definie par le respect des deux proprietes suivantes : 

• les deux conteneurs doivent avoir la meme taille ; 

• leurs elements doivent etre identiques deux a deux. 



Si le type des objets contenus dispose des operateurs d'inferiorite et de superiorites strictes, les memes 
operateurs seront egalement definis pour le conteneur. Ces operateurs utilisent l'ordre lexicographique 
pour determiner le classement entre deux conteneurs. Autrement dit, l'operateur d'inferiorite compare 
les elements des deux conteneurs un a un, et fixe son verdict des la premiere difference constatee. Si 
un conteneur est un sous-ensemble du deuxieme, le conteneur le plus petit est celui qui est inclus dans 
1' autre. 
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Note : Remarquez que la definition des operateurs de comparaison d'inferiorite et de superior- 
ite existe quel que soit le type des donnees que le conteneur peut stocker. Cependant, comme 
les conteneurs sont definis sous la forme de classes template, ces methodes ne sont instan- 
ciees que si elles sont effectivement utilisees dans les programmes. Ainsi, il est possible d'utiliser 
les conteneurs meme sur des types de donnees pour lesquels les operateurs d'inferiorite et de 
superiorite ne sont pas definis. Cependant, cette utilisation provoquera une erreur de compilation, 
car le compilateur cherchera a instancier les operateurs a ce moment. 



17.1.5. Methodes d'interet general 

Enfin, les conteneurs disposent de methodes generates permettant d'obtenir des informations sur leurs 
proprietes. En particulier, le nombre d'elements qu'ils contiennent peut etre determine grace a la 
methode size. La methode empty permet de determiner si un conteneur est vide ou non. La taille 
maximale que peut prendre un conteneur est indiquee quant a elle par la methode max_size. Pour 
finir, tous les conteneurs disposent d'une methode swap, qui prend en parametre un autre conteneur 
du meme type et qui realise l'echange des donnees des deux conteneurs. On utilisera de preference 
cette methode a toute autre technique d'echange car seules les references sur les structures de donnees 
des conteneurs sont echangees avec cette fonction, ce qui garantit une complexite independante de la 
taille des conteneurs. 



17.2. Les sequences 

Les sequences sont des conteneurs qui ont principalement pour but de stocker des objets afin de les 
traiter dans un ordre bien defini. Du fait de l'absence de clef permettant d'identifier les objets qu'elles 
contiennent, elles ne disposent d'aucune fonction de recherche des objets. Les sequences disposent 
done generalement que des methodes permettant de realiser l'insertion et la suppression d'elements, 
ainsi que le parcours des elements dans 1' ordre qu'elles utilisent pour les classer. 

17.2.1. Fonctionnalites communes 

II existe un grand nombre de classes template de sequences dans la bibliotheque standard qui per- 
mettent de couvrir la majorite des besoins des programmeurs. Ces classes sont relativement variees 
tant dans leurs implementations que dans leurs interfaces. Cependant, un certain nombre de fonc- 
tionnalites communes sont gerees par la plupart des sequences. Ce sont ces fonctionnalites que cette 
section se propose de vous decrire. Les fonctionnalites specifiques a chaque classe de sequence seront 
detaillees separement dans la Section 17.2.2.1. 

Les exemples fournis dans cette section se baseront sur le conteneur list, qui est le type de sequence 
le plus simple de la bibliotheque standard. Cependant, ils sont parfaitement utilisables avec les autres 
types de sequences de la bibliotheque standard, avec des niveaux de performances eventuellement 
differents en fonction des sequences choisies bien entendu. 

17.2.1.1. Construction et initialisation 

La construction et l'initialisation d'une sequence peuvent se faire de multiples manieres. Les se- 
quences disposent en effet de plusieurs constructeurs et de deux surcharges de la methode assign 
qui permet de leur affecter un certain nombre d'elements. Le constructeur le plus simple ne prend 
aucun parametre, hormis un allocateur standard a utiliser pour la gestion de la sequence, et permet 
de construire une sequence vide. Le deuxieme constructeur prend en parametre le nombre d'elements 
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initial de la sequence et la valeur de ces elements. Ce constructeur permet done de creer une sequence 
contenant deja un certain nombre de copies d'un objet donne. Enfin, le troisieme constructeur prend 
deux iterateurs sur une autre sequence d'objets qui devront etre copies dans la sequence en cours 
de construction. Ce constructeur peut etre utilise pour initialiser une sequence a partir d'une autre 
sequence ou d'un sous-ensemble de sequence. 

Les surcharges de la methode assign se comportent un peu comme les deux derniers constructeurs, 
a ceci pres qu'elles ne prennent pas d'allocateur en parametre. La premiere methode permet done de 
reinitialiser la liste et de la remplir avec un certain nombre de copies d'un objet donne, et la deuxieme 
permet de reinitialiser la liste et de la remplir avec une sequence d'objets definie par deux iterateurs. 

Exemple 17-1. Construction et initialisation d'une liste 

#include <iostream> 
#include <list> 

using namespace std; 

typedef list<int> li; 

void print (li &1) 
{ 

li::iterator i = l.begin(); 

while (i != 1 . end ( ) ) 

{ 

cout << *i << " " ; 
+ + i; 

} 

cout << endl; 
} 

int main (void) 
{ 

// Initialise une liste avec trois elements valant 5 : 

li 11 (3, 5) ; 

print (11) ; 

// Initialise une autre liste a partir de la premiere 

// (en fait on devrait appeler le constructeur de copie) : 

li 12 (ll.beginO , ll.endO); 

print (12) ; 

// Affecte 4 elements valant 2 a 11 : 

11. assign (4, 2); 

print (11) ; 

// Affecte 11 a 12 (de meme, on devrait normalement 

// utiliser l'operateur d' affectation) : 

12 . assign (11 .begin () , ll.endO); 

print (12 ) ; 

return 0; 



Bien entendu, il existe egalement un constructeur et un operateur de copie capables d' initialiser une 
sequence a partir d'une autre sequence du meme type. Ainsi, il n'est pas necessaire d'utiliser les 
constructeurs vus precedemment ni les methodes assign pour initialiser une sequence a partir d'une 
autre sequence de meme type. 
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17.2.1.2. Ajout et suppression d'elements 



L'insertion de nouveaux elements dans une sequence se fait normalement a l'aide de l'une des sur- 
charges de la methode insert. Bien entendu, il existe d'autres methodes specifiques a chaque conte- 
neur de type sequence et qui leur sont plus appropriees, mais ces methodes ne seront decrites que 
dans les sections consacrees a ces conteneurs. Les differentes versions de la methode insert sont 
recapitulees ci-dessous : 

iterator insert (iterator i, value_type valeur) 

Permet d'inserer une copie de la valeur specifiee en deuxieme parametre dans le conteneur. 
Le premier parametre est un iterateur indiquant l'endroit ou le nouvel element doit etre inse- 
re. L'insertion se fait immediatement avant l'element reference par cet iterateur. Cette methode 
renvoie un iterateur sur le dernier element insere dans la sequence. 

void insert ( iterator i, size_type n, value_type valeur) 

Permet d'inserer n copies de l'element specifie en troisieme parametre avant l'element reference 
par l'iterateur i donne en premier parametre. 

void insert ( iterator i, iterator premier, iterator dernier) 

Permet d'inserer tous les elements de l'intervalle defini par les iterateurs premier et dernier 
avant l'element reference par l'iterateur i. 



Exemple 17-2. Insertion d'elements dans une liste 

#include <iostream> 
tinclude <list> 

using namespace std; 

typedef list<int> li; 

void print (li &1) 
{ 

li::iterator i = l.begin(); 

while (i != 1 . end ( ) ) 

{ 

cout << *i << " " ; 

+ + i; 
} 

cout << endl; 
return ; 



int main (void) 
{ 

li 11; 

// Ajoute 5 a la liste : 

li::iterator i = 11 . insert (11 .begin () , 5); 

print (11) ; 

// Ajoute deux 3 a la liste : 

11 . insert (i, 2, 3) ; 

print (11) ; 

// Insere le contenu de 11 dans une autre liste 
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li 12; 

12 . insert (12 .begin () , ll.beginO, ll.endO) 

print (12 ) ; 
return 0; 



De maniere similaire, il existe deux surcharges de la methode erase qui permettent de specifier de 
differentes manieres les elements qui doivent etre supprimes d'une sequence. La premiere methode 
prend en parametre un iterateur sur l'element a supprimer, et la deuxieme un couple d'iterateurs 
donnant l'intervalle des elements de la sequence qui doivent etre supprimes. Ces deux methodes 
retournent un iterateur sur l'element suivant le dernier element supprime ou l'iterateur de fin de se- 
quence s'il n'existe pas de tel element. Par exemple, la suppression de tous les elements d'une liste 
peut etre realisee de la maniere suivante : 



// Recupere un iterateur sur le premier 

// element de la liste : 

list<int> :: iterator i = instance .begin () ; 

while (i != instance . end () ) 

{ 

i = instance .erase (i) ; 
} 

ou instance est une instance de la sequence Sequence. 

Vous noterez que la suppression d'un element dans une sequence rend invalide tous les iterateurs sur 
cet element. II est a la charge du programmeur de s'assurer qu'il n'utilisera plus les iterateurs ainsi 
invalides. La bibliotheque standard ne fournit aucun support pour le diagnostic de ce genre d'erreur. 

Note : En realite, I'insertion d'un element peut egalement invalider des iterateurs existants 
pour certaines sequences. Les effets de bord des methodes d'insertion et de suppression des 
sequences seront detailles pour chacune d'elle dans les sections qui leur sont dediees. 

II existe une methode clear dont le role est de vider completement un conteneur. On utilisera 
done cette methode dans la pratique, le code donne ci-dessous ne I'etait qu'a titre d'exemple. 



La complexite de toutes ces methodes depend directement du type de sequence sur lequel elles sont 
appliquees. Les avantages et les inconvenients de chaque sequence seront decrits dans la Section 
17.2.2. 



17.2.2. Les differents types de sequences 

La bibliotheque standard fournit trois classes fondamentales de sequence. Ces trois classes sont res- 
pectivement la classe list, la classe vector et la classe deque. Chacune de ces classes possede ses 
specificites en fonction desquelles le choix du programmeur devra se faire. De plus, la bibliotheque 
standard fournit egalement des classes adaptatrices permettant de construire des conteneurs equiva- 
lents, mais disposant d'une interface plus standard et plus habituelle aux notions couramment utilisees 
en informatique. Toutes ces classes sont decrites dans cette section, les adaptateurs etant abordes en 
derniere partie. 
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17.2.2.1. Les listes 



La classe template list est certainement l'une des plus importantes car, comme son nom l'indique, 
elle implemente une structure de liste chainee d' elements, ce qui est sans doute l'une des structures 
les plus utilisees en informatique. Cette structure est particulierement adaptee pour les algorithmes 
qui parcourent les donnees dans un ordre sequentiel. 

Les proprietes fondamentales des listes sont les suivantes : 

• elles implementent des iterateurs bidirectionnels. Cela signifie qu'il est facile de passer d'un ele- 
ment au suivant ou au precedent, mais qu'il n'est pas possible d'acceder aux elements de la liste de 
maniere aleatoire ; 

• elles permettent l'insertion et la suppression d'un element avec un cout constant, et sans invalider 
les iterateurs ou les references sur les elements de la liste existants. Dans le cas d'une suppression, 
seuls les iterateurs et les references sur les elements supprimes sont invalides. 



Les listes offrent done la plus grande souplesse possible sur les operations d'insertion et de suppres- 
sion des elements, en contrepartie de quoi les acces sont restreints a un acces sequentiel. 

Comme l'insertion et la suppression des elements en tete et en queue de liste peuvent se faire sans 
recherche, ce sont evidemment les operations les plus courantes. Par consequent, la classe template 
list propose des methodes specifiques permettant de manipuler les elements qui se trouvent en ces 
positions. L'insertion d'un element peut done etre realisee respectivement en tete et en queue de liste 
avec les methodes push_f ront et push_back. Inversement, la suppression des elements situes en 
ces emplacements est realisee avec les methodes pop_f ront et pop_back. Toutes ces methodes ne 
renvoient aucune valeur, aussi 1' acces aux deux elements situes en tete et en queue de liste peut-il etre 
realise respectivement par 1' intermediate des accesseurs front et back, qui renvoient tous deux une 
reference (eventuellement constante si la liste est elle-meme constante) sur ces elements. 

Exemple 17-3. Acces a la tete et a la queue d'une liste 

#include <iostream> 
#include <list> 

using namespace std; 

typedef list<int> li; 

int main (void) 
{ 

li 11; 

11 . push_back (2 ) ; 

11 . push_back (5) ; 

cout << "Tete : " << 11. f ront ( 

cout << "Queue : " << 11. back ( 

11 . push_f ront (7 ) ; 

cout << "Tete : " << 11. f ront ( 



cout << "Queue : " << 11. back ( 
11 .pop_back ( ) ; 

cout << "Tete : " << 11. f ront ( 
cout << "Queue : " << 11. back ( 
return 0; 



<< endl; 
<< endl; 

<< endl; 
<< endl; 

<< endl; 
<< endl; 
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Les listes disposent egalement de methodes specifiques qui permettent de leur appliquer des traite- 
ments qui leur sont propres. Ces methodes sont decrites dans le tableau ci-dessous : 

Tableau 17-1. Methodes specifiques aux listes 



Methode 


Fonction 


remove(const T &) 


Permet d'eliminer tous les elements d'une liste dont la valeur est egale a la 
valeur passee en parametre. L'ordre relatif des elements qui ne sont pas 
supprimes est inchange. La complexite de cette methode est lineaire en fonction 
du nombre d'elements de la liste. 


remove_if(Predicat) 


Permet d'eliminer tous les elements d'une liste qui verifient le predicat unaire 
passe en parametre. L'ordre relatif des elements qui ne sont pas supprimes est 
inchange. La complexite de cette methode est lineaire en fonction du nombre 
d'elements de la liste. 


unique(Predicat) 


Permet d'eliminer tous les elements pour lesquels le predicat binaire passe en 
parametre est verifie avec comme valeur 1' element courant et son predecesseur. 
Cette methode permet d'eliminer les doublons successifs dans une liste selon 
un critere defini par le predicat. Par souci de simplicite, il existe une surcharge 
de cette methode qui ne prend pas de parametres, et qui utilise un simple test 
d'egalite pour eliminer les doublons. L'ordre relatif des elements qui ne sont 
pas supprimes est inchange, et le nombre d' applications du predicat est 
exactement le nombre d'elements de la liste moins un si la liste n'est pas vide. 


splice(iterator 
position, list<T, 
Allocator> liste, 
iterator premier, 
iterateur dernier) 


Injecte le contenu de la liste fournie en deuxieme parametre dans la liste 
courante a partir de la position fournie en premier parametre. Les elements 
injectes sont les elements de la liste source identifies par les iterateurs premier 
et dernier. lis sont supprimes de la liste source a la volee. Cette methode 
dispose de deux autres surcharges, l'une ne fournissant pas d'iterateur de 
dernier element et qui insere uniquement le premier element, et F autre ne 
fournissant aucun iterateur pour referencer les elements a injecter. Cette 
derniere surcharge ne prend done en parametre que la position a laquelle les 
elements doivent etre inseres et la liste source elle-meme. Dans ce cas, la 
totalite de la liste source est inseree en cet emplacement. Generalement, la 
complexite des methodes splice est proportionnelle au nombre d'elements 
injectes, sauf dans le cas de la derniere surcharge, qui s'execute avec une 
complexite constante. 


sort(Predicat) 


Trie les elements de la liste dans l'ordre defini par le predicat binaire de 
comparaison passe en parametre. Encore une fois, il existe une surcharge de 
cette methode qui ne prend pas de parametre et qui utilise l'operateur 
d'inferiorite pour comparer les elements de la liste entre eux. L'ordre relatif des 
elements equivalents (e'est-a-dire des elements pour lesquels le predicat de 
comparaison n'a pas pu statuer d'ordre bien defini) est inchange a Tissue de 
1' operation de tri. On indique souvent cette propriete en disant que cette 
methode est stable. La methode sort s'applique avec une complexite egale a 
Nxln (N) , ou N est le nombre d'elements de la liste. 
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Methode 



Fonction 



merge(list<T, Injecte les elements de la liste fournie en premier parametre dans la liste 

Allocator>, courante en conservant l'ordre defini par le predicat binaire fourni en deuxieme 

Predicate) parametre. Cette methode suppose que la liste sur laquelle elle s'applique et la 

liste fournie en parametre sont deja triees selon ce predicat, et garantit que la 
liste resultante sera toujours triee. La liste fournie en argument est videe a 
Tissue de F operation. II existe egalement une surcharge de cette methode qui ne 
prend pas de second parametre et qui utilise l'operateur d'inferiorite pour 
comparer les elements des deux listes. La complexite de cette methode est 
proportionnelle a la somme des tailles des deux listes ainsi fusionnees. 



Inverse l'ordre des elements de la liste. Cette methode s'execute avec une 
complexite lineaire en fonction du nombre d'elements de la liste. 



Exemple 17-4. Manipulation de listes 

#include <iostream> 
#include <functional> 
#include <list> 

using namespace std; 

typedef list<int> li; 

void print (li &1) 

{ 

li::iterator i = l.beginO 
while (i != 1 . end ( ) ) 



I 



cout << *i << 
++i; 



} 

cout << endl; 

return ; 



} 



bool parity_even (int i) 
{ 

return (i & 1) == 0; 

} 

int main (void) 



// Construit une liste exemple 

li 1; 

1 .push_back (2 ) 

1 .push_back (5) 

1 .push_back (7 ) 

1 .push_back (7 ) 

1 .push_back (3) 

1 .push_back (3) 

1 .push_back (2 ) 

1 .push_back ( 6) 

1 .push_back ( 6) 
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1 .push_back ( 6) ; 

1 .push_back (3) ; 

1 .push_back (4 ) ; 

cout << "Liste de depart :" << endl; 

print (1) ; 

li 11; 

// Liste en ordre inverse : 

11 = 1; 

11 . reverse ( ) ; 

cout << "Liste inverse :" << endl; 

print (11) ; 

// Trie la liste : 

11 = 1; 

11. sort () ; 

cout << "Liste triee : " << endl; 

print (11) ; 

// Supprime tous les 3 : 

11 = 1; 

11 . remove (3 ) ; 

cout << "Liste sans 3 :" << endl; 

print (11) ; 

// Supprime les doublons : 

11 = 1; 

11 . unique ( ) ; 

cout << "Liste sans doublon :" << endl; 

print (11) ; 

// Retire tous les nombres pairs : 

11 = 1; 

11 . remove_if (ptr_fun (&parity_even) ) ; 

cout << "Liste sans nombre pair :" << endl; 

print (11) ; 

// Injecte une autre liste entre les 7 : 

11 = 1; 

li::iterator i = ll.begin(); 

++i; ++i; ++i; 

li 12; 

12 .push_back (35) ; 

12 .push_back (3 6) ; 

12 .push_back (37) ; 

11. spliced, 12, 12.begin(), 12.end()); 

cout << "Fusion des deux listes :" << endl; 

print (11) ; 

if (12.size() == 0) 

cout << "12 est vide" << endl; 
return 0; 



17.2.2.2. Les vecteurs 

La classe template vector de la bibliotheque standard fournit une structure de donnees dont la se- 
mantique est proche de celle des tableaux de donnees classiques du langage C/C++. L'acces aux 
donnees de maniere aleatoire est done realisable en un cout constant, mais l'insertion et la suppres- 
sion des elements dans un vecteur ont des consequences nettement plus lourdes que dans le cas des 
listes. 



Les proprietes des vecteurs sont les suivantes : 
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les iterateurs permettent les acces aleatoires aux elements du vecteur ; 

l'insertion ou la suppression d'un element a la fin du vecteur se fait avec une complexite constante, 
mais l'insertion ou la suppression en tout autre point du vecteur se fait avec une complexite lineaire. 
Autrement dit, les operations d' insertion ou de suppression necessitent a priori de deplacer tous les 
elements suivants, sauf si l'element insere ou supprime se trouve en derniere position ; 

dans tous les cas, l'insertion d'un element peut necessiter une reallocation de memoire. Cela a 
pour consequence qu'en general, les donnees du vecteur peuvent etre deplacees en memoire et que 
les iterateurs et les references sur les elements d'un vecteur sont a priori invalides a la suite d'une 
insertion. Cependant, si aucune reallocation n'a lieu, les iterateurs et les references ne sont pas 
invalides pour tous les elements situes avant l'element insere ; 

la suppression d'un element ne provoquant pas de reallocation, seuls les iterateurs et les references 
sur les elements suivant l'element supprime sont invalides. 



Note : Notez bien que les vecteurs peuvent effectuer une reallocation meme lorsque l'insertion se 
fait en derniere position. Dans ce cas, le cout de l'insertion est bien entendu tres eleve. Toutefois, 
I'algorithme de reallocation utilise est suffisament evolue pour garantir que ce cout est constant 
en moyenne (done de complexite constante). Autrement dit, les reallocations ne se font que tres 
rarement. 



Tout comme la classe list, la classe template vector dispose de methodes front et back qui per- 
mettent d'acceder respectivement au premier et au dernier element des vecteurs. Cependant, contrai- 
rement aux listes, seule les methodes push_back et pop_back sont definies, car les vecteurs ne 
permettent pas d'inserer et de supprimer leurs premiers elements de maniere rapide. 

En revanche, comme nous l'avons deja dit, les vecteurs ont la meme semantique que les tableaux et 
permettent done un acces rapide a tous leurs elements. La classe vector definit done une methode at 
qui prend en parametre 1'indice d'un element dans le vecteur et qui renvoie une reference, eventuelle- 
ment constante si le vecteur Test lui-meme, sur cet element. Si 1'indice fourni en parametre reference 
un element situe en dehors du vecteur, la methode at lance une exception out_of_range. De meme, il 
est possible d'appliquer l'operateur [ ] utilise habituellement pour acceder aux elements des tableaux. 
Cet operateur se comporte exactement comme la methode at, et est done susceptible de lancer une 
exception out_of_range. 

Exemple 17-5. Acces aux elements d'un vecteur 

#include <iostream> 
#include <vector> 

using namespace std; 

int main (void) 
{ 

typedef vector<int> vi; 

// Cree un vecteur de 10 elements : 

vi v(10) ; 

// Modifie quelques elements : 

v.at (2) =2; 

v.at (5) = 7; 

// Redimensionne le vecteur : 

v. resize (11) ; 

v.at (10) = 5; 



369 



Chapitre 17. Les conteneurs 



II Ajoute un element a la fin du vecteur : 

v.push_back (13) ; 

// Affiche le vecteur en utilisant l'operateur [' 

for (int i=0; i<v.size(); ++i) 

{ 

cout << v[i] << endl; 
} 
return 0; 



} 



Par ailleurs, la bibliotheque standard definit une specialisation de la classe template vector pour le 
type bool. Cette specialisation a essentiellement pour but de reduire la consommation memoire des 
vecteurs de booleens, en codant ceux-ci a raison d'un bit par booleen seulement. Les references des 
elements des vecteurs de booleens ne sont done pas reellement des booleens, mais plutot une classe 
speciale qui simule ces booleens tout en manipulant les bits reellement stockes dans ces vecteurs. 
Ce mecanisme est done completement transparent pour l'utilisateur, et les vecteurs de booleens se 
manipulent exactement comme les vecteurs classiques. 

Note : La classe de reference des vecteurs de booleens disposent toutefois d'une methode flip 
dont le role est d'inverser la valeur du bit correspondant au booleen que la reference represente. 
Cette methode peut etre pratique a utiliser lorsqu'on desire inverser rapidement la valeur d'un des 
elements du vecteur. 



17.2.2.3. Les deques 

Pour ceux a qui les listes et les vecteurs ne conviennent pas, la bibliotheque standard fournit un conte- 
neur plus evolue qui offre un autre compromis entre la rapidite d' acces aux elements et la souplesse 
dans les operations d'ajout ou de suppression. II s'agit de la classe template deque, qui implemente 
une forme de tampon circulaire dynamique. 

Les proprietes des deques sont les suivantes : 

• les iterateurs des deques permettent les acces aleatoires a leurs elements ; 

• 1' insertion et la suppression des elements en premiere et en derniere position se fait avec un cout 
constant. Notez ici que ce cout est toujours le meme, et que, contrairement aux vecteurs, il ne s'agit 
pas d'un cout amorti (autrement dit, ce n'est pas une moyenne). En revanche, tout comme pour les 
vecteurs, 1' insertion et la suppression aux autres positions se fait avec une complexite lineaire ; 

• contrairement aux vecteurs, tous les iterateurs et toutes les references sur les elements de la deque 
deviennent systematiquement invalides lors d'une insertion ou d'une suppression d'element aux 
autres positions que la premiere et la derniere ; 

de meme, l'insertion d'un element en premiere et derniere position invalide tous les iterateurs 
sur les elements de la deque. En revanche, les references sur les elements restent valides. Remar- 
quez que la suppression d'un element en premiere et en derniere position n'a aucun impact sur les 
iterateurs et les references des elements autres que ceux qui sont supprimes. 



Comme vous pouvez le constater, les deques sont done extremement bien adaptes aux operations 
d' insertion et de suppression en premiere et en derniere position, tout en fournissant un acces rapide 
a leurs elements. En revanche, les iterateurs existants sont systematiquement invalides, quel que soit 
le type d'operation effectuee, hormis la suppression en tete et en fin de deque. 
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Comme elle permet un acces rapide a tous ses elements, la classe template deque dispose de toutes 
les methodes d'insertion et de suppression d'elements des listes et des vecteurs. Outre les methodes 
push_f ront, pop_f ront, push_back, pop_back et les accesseurs front et back, la classe deque 
definit done la methode at, ainsi que Foperateur d'acces aux elements de tableaux [ ] . L' utilisation de 
ces methodes est strictement identique a celle des methodes homonymes des classes list et vector 
et ne devrait done pas poser de probleme particulier. 



17.2.2.4. Les adaptateurs de sequences 

Les classes des sequences de base list, vector et deque sont supposees satisfaire a la plupart des 
besoins courants des programmeurs. Cependant, la bibliotheque standard fournit des adaptateurs pour 
transformer ces classes en d'autres structures de donnees plus classiques. Ces adaptateurs permettent 
de construire des piles, des files et des files de priorite. 

17.2.2.4.1. Les piles 

Les piles sont des structures de donnees qui se comportent, comme leur nom l'indique, comme un 
empilement d'objets. Elles ne permettent done d'acceder qu'aux elements situes en haut de la pile, 
et la recuperation des elements se fait dans l'ordre inverse de leur empilement. En raison de cette 
propriete, on les appelle egalement couramment LIFO, acronyme de 1' anglais « Last In First Out » 
(dernier entre, premier sorti). 

La classe adaptatrice definie par la bibliotheque standard C++ pour implementer les piles est la classe 
template stack. Cette classe utilise deux parametres template : le type des donnees lui-meme et le 
type d'une classe de sequence implementant au moins les methodes back, push_back et pop_back. 
II est done parfaitement possible d'utiliser les listes, deques et vecteurs pour implementer une pile a 
l'aide de cet adaptateur. Par defaut, la classe stack utilise une deque, et il n'est done generalement pas 
necessaire de specifier le type du conteneur a utiliser pour realiser la pile. 

L'interface des piles se reduit au strict minimum, puisqu'elles ne permettent de manipuler que leur 
sommet. La methode push permet d'empiler un element sur la pile, et la methode pop de Fen retirer. 
Ces deux methodes ne renvoient rien, Faeces a F element situe au sommet de la pile se fait done par 
F intermediate de la methode top. 

Exemple 17-6. Utilisation d'une pile 

tinclude <iostream> 
tinclude <stack> 

using namespace std; 

int main (void) 
{ 

typedef stack<int> si; 

// Cree une pile : 

si s; 

// Empile quelques elements : 

s .push (2 ) ; 

s .push (5) ; 

s .push (8 ) ; 

// Affiche les elements en ordre inverse : 

while (!s.empty()) 

{ 

cout << s.topO << endl; 

s.pop () ; 
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return 0; 



17.2.2.4.2. Les files 

Les files sont des structures de donnees similaires aux piles, a la difference pres que les elements 
sont mis les uns a la suite des autres au lieu d'etre empiles. Leur comportement est done celui d'une 
file d'attente ou tout le monde serait honnete (e'est-a-dire que personne ne doublerait les autres). Les 
derniers entres sont done ceux qui sortent egalement en dernier, d'ou leur denomination de FIFO (de 
1' anglais « First In First Out »). 

Les files sont implementees par la classe template queue. Cette classe utilise comme parametre 
template le type des elements stockes ainsi que le type d'un conteneur de type sequence pour lequel 
les methodes front, back, push_back et pop_f ront sont implementees. En pratique, il est possible 
d'utiliser les listes et les deques, la classe queue utilisant d'ailleurs ce type de sequence par defaut 
comme conteneur sous-jacent. 

Note : Ne confondez pas la classe queue et la classe deque. La premiere n'est qu'un simple 
adaptateur pour les files d'elements, alors que la deuxieme est un conteneur tres evolue et beau- 
coup plus complexe. 



Les methodes fournies par les files sont les methodes front et back, qui permettent d'acceder res- 
pectivement au premier et au dernier element de la file d'attente, ainsi que les methodes push et pop, 
qui permettent respectivement d'ajouter un element a la fin de la file et de supprimer 1' element qui se 
trouve en tete de file. 

Exemple 17-7. Utilisation d'une file 

#include <iostream> 
#include <queue> 

using namespace std; 

int main (void) 
{ 

typedef queue<int> qi; 

// Cree une file : 

qi q; 

// Ajoute quelques elements : 

q.push (2 ) ; 

q.push (5) ; 

q.push (8 ) ; 

// Affiche recupere et affiche les elements : 

while (Iq.emptyO) 

{ 

cout << q. front () << endl; 

q.pop () ; 
} 
return 0; 
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17.2.2.4.3. Les files de priorites 



Enfin, la bibliotheque standard fournit un adaptateur permettant d'implementer les files de priorites. 
Les files de priorites ressemblent aux files classiques, mais ne fonctionnent pas de la meme maniere. 
En effet, contrairement aux files normales, l'element qui se trouve en premiere position n'est pas 
toujours le premier element qui a ete place dans la file, mais celui qui dispose de la plus grande 
valeur. C'est cette propriete qui a donne son nom aux files de priorites, car la priorite d'un element est 
ici donnee par sa valeur. Bien entendu, la bibliotheque standard permet a l'utilisateur de definir son 
propre operateur de comparaison, afin de lui laisser specifier l'ordre qu'il veut utiliser pour definir la 
priorite des elements. 

Note : On prendra garde au fait que la bibliotheque standard n'impose pas aux files de priorites 
de se comporter comme des files classiques avec les elements de priorites egales. Cela signifie 
que si plusieurs elements de priorite egale sont inseres dans une file de priorite, ils n'en sortiront 
pas forcement dans l'ordre d'insertion. On dit generalement que les algorithmes utilises par les 
files de priorites ne sont pas stables pour traduire cette propriete. 



La classe template fournie par la bibliotheque standard pour faciliter 1' implementation des files 
de priorite est la classe priority _queue. Cette classe prend trois parametres template : le type des 
elements stockes, le type d'un conteneur de type sequence permettant un acces direct a ses elements 
et implementant les methodes front, push_back et pop_back, et le type d'un predicat binaire a 
utiliser pour la comparaison des priorites des elements. On peut done implementer une file de priorite a 
partir d'un vecteur ou d'une deque, sachant que, par defaut, la classe priority_queue utilise un vecteur. 
Le predicat de comparaison utilise par defaut est le foncteur less<T>, qui effectue une comparaison 
a l'aide de 1'operateur d'inferiorite des elements stockes dans la file. 

Comme les files de priorites se reorganisent a chaque fois qu'un nouvel element est ajoute en fin 
de file, et que cet element ne se retrouve par consequent pas forcement en derniere position s'il est 
de priorite elevee, acceder au dernier element des files de priorite n'a pas de sens. II n'existe done 
qu'une seule methode permettant d' acceder a l'element le plus important de la pile : la methode 
top. En revanche, les files de priorite implementent effectivement les methodes push et pop, qui 
permettent respectivement d'ajouter un element dans la file de priorite et de supprimer l'element le 
plus important de cette file. 

Exemple 17-8. Utilisation d'une file de priorite 

#include <iostream> 
#include <queue> 

using namespace std; 

// Type des donnees stockees dans la file : 

struct A 

{ 

int k; // Priorite 

const char *t; // Valeur 

A() : MO) , t (0) {} 

A (int k, const char *t) : k (k) , t(t) {} 



// Foncteur de comparaison selon les priorites : 
class C 
{ 
public : 
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bool operator () (const A sal, const A &a2) 
{ 

return al.k < a2.k ; 
} 

}; 

int main (void) 
{ 

// Construit quelques objets : 

A al(l, "Priorite faible"); 

A a2(2, "Priorite moyenne 1"); 

A a3(2, "Priorite moyenne 2 " ) ; 

A a4(3, "Priorite haute 1"); 

A a5(3, "Priorite haute 2 " ) ; 

// Construit une file de priorite : 

priority_queue<A, vector<A>, C> pq; 

// Ajoute les elements : 

pq.push (a5) ; 

pq.push (a3) ; 

pq.push (al) ; 

pq.push (a2) ; 

pq.push (a4) ; 

// Recupere les elements par ordre de priorite 

while ( !pq. empty () ) 

{ 

cout << pq.topO .t << endl; 
pq.popO ; 



} 



return 0; 



Note : En raison de la necessite de reorganiser I'ordre du conteneur sous-jacent a chaque ajout 
ou suppression d'un element, les methodes push et pop s'executent avec une complexity en 
in <n) , ou n est le nombre d'elements presents dans la file de priorite. 

Les files de priorite utilisent en interne la structure de tas, que Ton decrira dans le chapitre traitant 
des algorithmes de la bibliotheque standard a la section Section 18.3.1. 



17.3. Les conteneurs associatifs 

Contrairement aux sequences, les conteneurs associatifs sont capables d' identifier leurs elements a 
l'aide de la valeur de leur clef. Grace a ces clefs, les conteneurs associatifs sont capables d'effectuer 
des recherches d'elements de maniere extremement performante. En effet, les operations de recherche 
se font generalement avec un cout logarithmique seulement, ce qui reste generalement raisonnable 
meme lorsque le nombre d'elements stockes devient grand. Les conteneurs associatifs sont done par- 
ticulierement adaptes lorsqu'on a besoin de realiser un grand nombre d'operation de recherche. 

La bibliotheque standard distingue deux types de conteneurs associatifs : les conteneurs qui differen- 
cient la valeur de la clef de la valeur de l'objet lui-meme et les conteneurs qui considerent que les 
objets sont leur propre clef. Les conteneurs de la premiere categorie constituent ce que Ton appelle 
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des associations car ils permettent d'associer des clefs aux valeurs des objets. Les conteneurs associa- 
tifs de la deuxieme categorie sont appeles quant a eux des ensembles, en raison du fait qu'ils servent 
generalement a indiquer si un objet fait partie ou non d'un ensemble d'objets. On ne s'interesse dans 
ce cas pas a la valeur de l'objet, puisqu'on la connait deja si on dispose de sa clef, mais plutot a son 
appartenance ou non a un ensemble donne. 

Si tous les conteneurs associatifs utilisent la notion de clef, tous ne se comportent pas de maniere 
identique quant a l'utilisation qu'ils en font. Pour certains conteneurs, que Ton qualifie de conteneurs 
« a clefs uniques », chaque element contenu doit avoir une clef qui lui est propre. II est done impos- 
sible d'inserer plusieurs elements distincts avec la meme clef dans ces conteneurs. En revanche, les 
conteneurs associatif dits « a clefs multiples » permettent l'utilisation d'une meme valeur de clef pour 
plusieurs objets distincts. L' operation de recherche d'un objet a partir de sa clef peut done, dans ce 
cas, renvoyer plus d'un seul objet. 

La bibliotheque standard fournit done quatre types de conteneurs au total, selon que ce sont des asso- 
ciations ou des ensembles, et selon que ce sont des conteneurs associatifs a clefs multiples ou non. Les 
associations a clefs uniques et a clefs multiple sont implementees respectivement par les classes tem- 
plate map et multimap, et les ensembles a clefs uniques et a clefs multiples par les classes template 
set et multiset. Cependant, bien que ces classes se comportent de maniere profondement differentes, 
elles fournissent les memes methodes permettant de les manipuler. Les conteneurs associatifs sont 
done moins heteroclites que les sequences, et leur manipulation en est de beaucoup facilitee. 

Les sections suivantes presentent les differentes fonctionnalites des conteneurs associatifs dans leur 
ensemble. Les exemples seront donnes en utilisant la plupart du temps la classe template map, car 
e'est certainement la classe la plus utilisee en pratique en raison de sa capacite a stocker et a retrouver 
rapidement des objets identifies de maniere unique par un identifiant. Cependant, certains exemples 
utiliseront des conteneurs a clefs multiples afin de bien montrer les rares differences qui existent entre 
les conteneurs a clefs uniques et les conteneurs a clefs multiples. 

17.3.1. Generalites et proprietes de base des clefs 

La contrainte fondamentale que les algorithmes des conteneurs associatifs imposent est qu'il existe 
une relation d'ordre pour le type de donnee utilise pour les clefs des objets. Cette relation peut etre 
definie soit implicitement par un operateur d'inferiorite, soit par un foncteur que Ton peut specifier 
en tant que parametre template des classes des conteneurs. 

Alors que l'ordre de la suite des elements stockes dans les sequences est tres important, ce n'est pas le 
cas avec les conteneurs associatifs, car ceux-ci se basent exclusivement sur l'ordre des clefs des objets. 
En revanche, la bibliotheque standard C++ garantit que le sens de parcours utilise par les iterateurs 
des conteneurs associatifs est non decroissant sur les clefs des objets iteres. Cela signifie que le test 
d'inferiorite strict entre la clef de l'element suivant et la clef de l'element courant est toujours faux, 
ou, autrement dit, l'element suivant n'est pas plus petit que l'element courant. 

Note : Attention, cela ne signifie aucunement que les elements sont classes dans l'ordre croissant 
des clefs. En effet, I'existence d'un operateur d'inferiorite n'implique pas forcement celle d'un 
operateur de superiority d'une part, et deux valeurs comparables par cet operateur ne le sont pas 
forcement par I'operateur de superiority. L'element suivant n'est done pas forcement plus grand 
que l'element courant. En particulier, pour les conteneurs a clefs multiples, les clefs de deux 
elements successifs peuvent etre egales. 

En revanche, le classement utilise par les iterateurs des conteneurs a clefs uniques est plus fort, 
puisque dans ce cas, on n'a pas a se soucier des clefs ayant la meme valeur. La sequence des 
valeurs iterees est done cette fois strictement croissante, e'est-a-dire que la clef de l'element 
courant est toujours strictement inferieure a la clef de l'element suivant. 
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Comme pour tous les conteneurs, le type des elements stockes par les conteneurs associatifs est le 
type value_type. Cependant, contrairement aux sequences, ce type n'est pas toujours le type tem- 
plate par lequel le conteneur est parametre. En effet, ce type est une paire contenant le couple de 
valeurs forme par la clef et par l'objet lui-meme pour toutes les associations (c'est-a-dire pour les map 
et les multimap). Dans ce cas, les methodes du conteneur qui doivent effectuer des comparaisons sur 
les objets se basent uniquement sur le champ first de la paire encapsulant le couple (clef, valeur) 
de chaque objet. Autrement dit, les comparaisons d' objets sont toujours definies sur les clefs, et ja- 
mais sur les objets eux-memes. Bien entendu, pour les ensembles, le type value_type est strictement 
equivalent au type template par lequel ils sont parametres. 

Pour simplifier 1' utilisation de leurs clefs, les conteneurs associatifs definissent quelques types com- 
plementaires de ceux que Ton a dejapresentes dans la Section 17.1.2. Le plus important de ces types 
est sans doute le type key_type qui, comme son nom l'indique, represente le type des clefs utilisees 
par ce conteneur. Ce type constitue done, avec le type value_type, l'essentiel des informations de 
typage des conteneurs associatifs. Enfin, les conteneurs definissent egalement des types de predicats 
permettant d'effectuer des comparaisons entre deux clefs et entre deux objets de type value_type. II 
s'agit des types key_compare et value_compare. 



17.3.2. Construction et initialisation 

Les conteneurs associatifs disposent de plusieurs surcharges de leurs constructeurs qui permettent de 
les creer et de les initialiser directement. De maniere generale, ces constructeurs prennent tous deux 
parametres afin de laisser au programmeur la possibilite de definir la valeur du foncteur qu'ils doivent 
utiliser pour comparer les clefs, ainsi qu'une instance de l'allocateur a utiliser pour les operations 
memoire. Comme pour les sequences, ces parametres disposent de valeurs par defaut, si bien qu'en 
general il n'est pas necessaire de les preciser. 

Hormis le constructeur de copie et le constructeur par defaut, les conteneurs associatifs fournissent 
un troisieme constructeur permettant de les initialiser a partir d'une serie d' objets. Ces objets sont 
specifies par deux iterateurs, le premier indiquant le premier objet a inserer dans le conteneur et le 
deuxieme l'iterateur referencant l'element suivant le dernier element a inserer. L'utilisation de ce 
constructeur est semblable au constructeur du meme type defini pour les sequences et ne devrait done 
pas poser de probleme particulier. 

Exemple 17-9. Construction et initialisation d'une association simple 

#include <iostream> 
#include <map> 
#include <list> 

using namespace std; 

int main (void) 
{ 

typedef map<int, char *> Int2String; 

// Remplit une liste d' elements pour ces maps : 

typedef list<pair<int, char *> > lv; 

lv 1; 

1 .push_back (lv : : value_type ( 1, "Un" ) ) ; 

1 .push_back (lv : : value_type (2 , "Deux" ) ) ; 

1 .push_back (lv: : value_type (5, "Trois" ) ) ; 

1 .push_back (lv: : value_type (6, "Quatre" ) ) ; 

// Construit une map et 1' initialise avec la liste : 

Int2String i2s ( 1 . begin () , 1 . end ( ) ) ; 
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II Affiche le contenu de la map : 
Int2String :: iterator i = i2s.begin() 
while (i != i2s.end()) 
{ 

cout << i->second << endl; 

+ + i; 
} 
return 0; 



Note : Contrairement aux sequences, les conteneurs associatifs ne disposent pas de methode 
assign permettant d'initialiser un conteneur avec des objets provenant d'une sequence ou d'un 
autre conteneur associatif. En revanche, ils disposent d'un constructeur et d'un operateur de 
copie. 



17.3.3. Ajout et suppression d'elements 

Du fait de l'existence des clefs, les methodes d'insertion et de suppression des conteneurs associatifs 
sont legerement differentes de celles des sequences. De plus, elles n'ont pas tout a fait la meme signi- 
fication. En effet, les methodes d'insertion des conteneurs associatifs ne permettent pas, contrairement 
a celles des sequences, de specifier V emplacement ou un element doit etre insere puisque l'ordre des 
elements est impose par la valeur de leur clef. Les methodes d'insertion des conteneurs associatifs 
sont presentees ci-dessous : 

iterator insert (iterator i, const value_type Svaleur) 

Insere la valeur valeur dans le conteneur. L'iterateur i indique l'emplacement probable dans le 
conteneur ou l'insertion doit etre faite. Cette methode peut done etre utilisee pour les algorithmes 
qui connaissent deja plus ou moins l'ordre des elements qu'ils inserent dans le conteneur afin 
d'optimiser les performances du programme. En general, l'insertion se fait avec une complexite 
de in (N) (ou N est le nombre d'elements deja presents dans le conteneur). Toutefois, si l'element 
est insere apres l'iterateur i dans le conteneur, la complexite est constante. L'insertion se fait 
systematiquement pour les conteneurs a clefs multiples, mais peut ne pas avoir lieu si un element 
de meme clef que celui que Ton veut inserer est deja present pour les conteneurs a clefs uniques. 
Dans tous les cas, la valeur retournee est un iterateur referencant l'element insere ou l'element 
ayant la meme clef que l'element a inserer. 

void insert ( iterator premier, iterator dernier) 

Insere les elements de l'intervalle defini par les iterateurs premier et dernier dans le conte- 
neur. La complexite de cette methode est nxin (n+N) en general, ou N est le nombre d'elements 
deja presents dans le conteneur et n est le nombre d'elements a inserer. Toutefois, si les ele- 
ments a inserer sont classes dans l'ordre de l'operateur de comparaison utilise par le conteneur, 
l'insertion se fait avec un cout proportionnel au nombre d'elements a inserer. 

pair<iterator, bool> insert (const value_type Svaleur) 

Insere ou tente d'inserer un nouvel element dans un conteneur a clefs uniques. Cette methode 
renvoie une paire contenant l'iterateur referencant cet element dans le conteneur et un booleen 
indiquant si l'insertion a effectivement eu lieu. Cette methode n'est definie que pour les conte- 
neurs associatifs a clefs uniques (e'est-a-dire les map et les set). Si aucun element du conteneur 
ne correspond a la clef de l'element passe en parametre, cet element est insere dans le conteneur 
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et la valeur renvoyee dans le deuxieme champ de la paire vaut true. En revanche, si un autre 
element utilisant cette clef existe deja dans le conteneur, aucune insertion n'a lieu et le deuxieme 
champ de la paire renvoyee vaut alors false. Dans tous les cas, l'iterateur stocke dans le pre- 
mier champ de la valeur de retour reference l'element insere ou trouve dans le conteneur. La 
complexite de cette methode est logarithmique. 

iterator insert (const value_type Svaleur] 

Insere un nouvel element dans un conteneur a clefs multiples. Cette insertion se produit qu'il 
y ait deja ou non un autre element utilisant la meme clef dans le conteneur. La valeur retour- 
nee est un iterateur referencant le nouvel element insere. Vous ne trouverez cette methode que 
sur les conteneurs associatifs a clefs multiples, c'est-a-dire sur les multimap et les multiset. La 
complexite de cette methode est logarithmique. 



Comme pour les sequences, la suppression des elements des conteneurs associatifs se fait a l'aide des 
surcharges de la methode erase. Les differentes versions de cette methode sont indiquees ci-dessous : 



void erase (iterator i) 

Permet de supprimer l'element reference par l'iterateur i. Cette operation a un cout amorti 
constant car aucune recherche n'est necessaire pour localiser l'element. 

void erase (iterator premier, iterator dernier) 

Supprime tous les elements de l'intervalle defini par les deux iterateurs premier et dernier. 
La complexite de cette operation est in (N) +n, ou N est le nombre d' elements du conteneur avant 
suppression et n est le nombre d' elements qui seront supprimes. 

size_type erase (key_type clef) 

Supprime tous les elements dont la clef est egale a la valeur passee en parametre. Cette operation 
a pour complexite in (N) +n, ou N est le nombre d'elements du conteneur avant suppression et 
n est le nombre d'elements qui seront supprimes. Cette fonction retourne le nombre d'elements 
effectivement supprimes. Ce nombre peut etre nul si aucun element ne correspond a la clef 
fournie en parametre, ou valoir 1 pour les conteneurs a clefs uniques, ou etre superieur a 1 pour 
les conteneurs a clefs multiples. 

Les conteneurs associatifs disposent egalement, tout comme les sequences, d'une methode clear 
permettant de vider completement un conteneur. Cette operation est realisee avec un cout proportion- 
nel au nombre d'elements se trouvant dans le conteneur. 

Exemple 17-10. Insertion et suppression d'elements d'une association 

#include <iostream> 
♦include <map> 

using namespace std; 

typedef map<int, char *> Int2String; 

void print ( Int2String &m) 

{ 

Int2String :: iterator i = m. begin (); 

while (i != m.endO) 

{ 
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cout << i->second << endl; 

+ + i; 



return 



int main (void) 



{ 



// Construit une association Entier -> Chaine : 

Int2String m; 

// Ajoute quelques elements : 

m. insert (Int2String: : value_type (2, "Deux") ) ; 

pair<Int2String :: iterator , bool> res = 

m. insert (Int2String: : value_type (3, "Trois ")) ; 
// On peut aussi specifier un indice sur 
// 1' emplacement ou 1' insertion aura lieu : 
m. insert (res. first, 

Int 2 St ring : : value_type (5, "Cinq" ) ) ; 
// Affiche le contenu de 1' association : 
print (m) ; 

// Supprime 1' element de clef 2 : 
m. erase (2) ; 

// Supprime 1' element "Trois" par son iterateur : 
m.erase(res. first) ; 
print (m) ; 
return 0; 



17.3.4. Fonctions de recherche 

Les fonctions de recherche des conteneurs associatifs sont puissantes et nombreuses. Ces methodes 
sont decrites ci-dessous : 



iterator f ind (key_type clef) 

Renvoie un iterateur referencant un element du conteneur dont la clef est egale a la valeur passee 
en parametre. Dans le cas des conteneurs a clefs multiples, l'iterateur renvoye reference un des 
elements dont la clef est egale a la valeur passee en parametre. Attention, ce n'est pas forcement 
le premier element du conteneur verifiant cette propriete. Si aucun element ne correspond a la 
clef, l'iterateur de fin du conteneur est renvoye. 

iterator lower_bound (key_type clef) 

Renvoie un iterateur sur le premier element du conteneur dont la clef est egale a la valeur passee 
en parametre. Les valeurs suivantes de l'iterateur re ferenceront les elements suivants dont la clef 
est superieure ou egale a la clef de cet element. 

iterator upper_bound (key_type clef) 

Renvoie un iterateur sur F element suivant le dernier element dont la clef est egale a la valeur 
passee en parametre. S'il n'y a pas de tel element, c'est-a-dire si le dernier element du conteneur 
utilise cette valeur de clef, renvoie l'iterateur de fin du conteneur. 
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pair<iterator, iterator> equal_range (key_type clef) 

Renvoie une paire d'iterateurs egaux respectivement aux iterateurs renvoyes par les methodes 
lower_bound et upper_bound. Cette paire d'iterateurs reference done tous les elements du 
conteneur dont la clef est egale a la valeur passee en parametre. 



Exemple 17-11. Recherche dans une association 

#include <iostream> 
#include <map> 

using namespace std; 

int main (void) 



// Declare une map a clefs multiples : 

typedef multimap<int , char *> Int2String; 

Int2String m; 

// Remplit la map : 

m. insert (Int2String 

m. insert (Int2String 

m. insert (Int2String 

m. insert (Int2String 

m. insert (Int2String 

m. insert (Int2String 



: value_type (2, "Deux")); 

: value_type (3, "Drei")); 

:value_type (1, "Un")); 

: value_type (3, "Three")); 

:value_type (4, "Quatre")); 

: value_type (3, "Trois")); 
// Recherche un element de clef 4 et l'affiche : 
Int2String :: iterator i = m.find(4); 

cout << i->first << " : " << i->second << endl; 
// Recherche le premier element de clef 3 : 
i = m. lower_bound (3) ; 

// Affiche tous les elements dont la clef vaut 3 : 
while (i != m. upper_bound (3) ) 



cout << i->first << 
++i; 



<< i->second << endl; 



// Effectue la mime operation, mais de maniere plus efficace 
// (upper_bound n'est pas appelee a chaque iteration) : 
pair<Int2String :: iterator , Int2String : : iterator> p = 

m. equal_range (3) ; 
for (i = p. first; i != p. second; ++i) 



cout << i->first << 



<< i->second << endl; 



return 0; 



Note : II existe egalement des surcharges const pour ces quatre methodes de recherche afin de 
pouvoir les utiliser sur des conteneurs constants. Ces methodes retournent des valeurs de type 
const_iterator au lieu des iterateurs classiques, car il est interdit de modifier les valeurs stockees 
dans un conteneur de type const. 

La classe template map fournit egalement une surcharge pour I'operateur d'acces aux mem- 
bres de tableau u . Cet operateur renvoie la valeur de I'element reference par sa clef et permet 
d'obtenir directement cette valeur sans passer par la methode find et un dereferencement de 
I'iterateur ainsi obtenu. Cet operateur insere automatiquement un nouvel element construit avec 
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la valeur par defaut du type des elements stockes dans la map si aucun element ne correspond 
a la clef fournie en parametre. Contrairement a I'operateur n des classes vector et deque, cet 
operateur ne renvoie done jamais I'exception out_of__range. 



Les recherches dans les conteneurs associatifs s'appuient sur le fait que les objets disposent d'une 
relation d'ordre induite par le foncteur less applique sur le type des donnees qu'ils manipulent. Ce 
comportement est generalement celui qui est souhaite, mais il existe des situations ou ce foncteur 
ne convient pas. Par exemple, on peut desirer que le classement des objets se fasse sur une de leur 
donnee membre seulement, ou que la fonction de comparaison utilisee pour classer les objets soit 
differente de celle induite par le foncteur less. La bibliotheque standard fournit done la possibilite de 
specifier un foncteur de comparaison pour chaque conteneur associatif, en tant que parametre template 
complementaire au type de donnees des objets contenus. Ce foncteur doit, s'il est specifie, etre precise 
avant le type de 1'allocateur memoire a utiliser. II pourra etre construit a partir des facilites fournies 
par la bibliotheque standard pour la creation et la manipulation des foncteurs. 

Exemple 17-12. Utilisation d'un foncteur de comparaison personnalise 

#include <iostream> 
#include <map> 
#include <string> 
#include <functional> 
#include <cstring> 

using namespace std; 

// Fonction de comparaison de chaines de caracteres 

// non sensible a la casse des lettres : 

bool stringless_nocase (const string &sl, const string &s2) 

{ 

return ( strcaseemp (si . c_str ( ) , s2.c_str()) < ) ; 



int main (void) 
{ 

// Definit le type des associations chaines -> entiers 

// dont la clef est indexee sans tenir compte 

// de la casse des lettres : 

typedef map<string, int, 

pointer_to_binary_f unction<const string &, 
const string &, bool> > String2Int; 

String2Int m (ptr_fun (stringless_nocase) ) ; 

// Insere quelques elements dans la map : 



: value_type ( "a . Un", 1 ) ) ; 
: value_type ( "B . Deux", 2 ) ) ; 
: value_type ( "c . Trois", 3)); 



m. insert (String2Int 

m. insert (String2Int 

m. insert (String2Int 

// Affiche le contenu de la map : 

String2Int :: iterator i = m. begin (); 

while (i != m.endO) 

{ 

cout << i->first << " : " << i->second << endl; 

+ + i; 
} 
return 0; 



} 
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Dans cet exemple, le type du foncteur est specifie en troisieme parametre de la classe template map. 
Ce type est une instance de la classe template pointer_to_binary_function pour les types string et 
bool. Comme on l'a vu dans la Section 13.5, cette classe permet d'encapsuler toute fonction binaire 
dans un foncteur binaire. II ne reste done qu'a specifier l'instance du foncteur que la classe template 
map doit utiliser, en la lui fournissant dans son constructeur. L' exemple precedent utilise la fonction 
utilitaire ptr_fun de la bibliotheque standard pour construire ce foncteur a partir de la fonction 
st r ingles s_nocase. 

En fait, il est possible de passer des foncteurs beaucoup plus evolues a la classe map, qui peuvent 
eventuellement etre parametres par d'autres parametres que la fonction de comparaison a utiliser pour 
comparer deux clefs. Cependant, il est rare d' avoir a ecrire de tels foncteurs et meme, en general, il est 
courant que la fonction binaire utilisee soit toujours la meme. Dans ce cas, il est plus simple de definir 
directement le foncteur et de laisser le constructeur de la classe map prendre sa valeur par defaut. 
Ainsi, seul le parametre template donnant le type du foncteur doit etre specifie, et l'utilisation des 
conteneurs associatif en est d'autant facilitee. L' exemple suivant montre comment la comparaison de 
chaines de caracteres non sensible a la casse peut etre implementee de maniere simplifiee. 

Exemple 17-13. Definition directe du foncteur de comparaison pour les recherches 

#include <iostream> 
#include <string> 
#include <map> 
#include <functional> 
#include <cstring> 

using namespace std; 

// Classe de comparaison de chaines de caracteres : 

class StringLessNoCase : public binary_f unction<string, string, bool> 

{ 

public : 

bool operator () (const string &sl, const string &s2) 

{ 

return ( strcaseemp (si . c_str ( ) , s2.c_str()) < 0); 



int main (void) 
{ 

// Definition du type des associations chaines -> entiers 

// en specifiant directement le type de foncteur a utiliser 

// pour les comparaisons de clefs : 

typedef map<string, int, StringLessNoCase> String2Int; 

// Instanciation d' une association en utilisant 

// la valeur par defaut du foncteur de comparaison : 

String2Int m; 

// Utilisation de la map : 

m. insert (String2Int :: value_type ( "a . Un", 1 ) ) ; 

m. insert (String2Int :: value_type ( "B . Deux", 2 ) ) ; 

m. insert (String2Int :: value_type ( "c . Trois", 3)); 

String2Int :: iterator i = m. begin (); 

while (i != m.end()) 

{ 

cout << i->first << " : " << i->second << endl; 
+ + i; 

} 
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return ; 
} 



Note : Les deux exemples precedents utilisent la fonction strcasecmp de la bibliotheque C stan- 
dard pour effectuer des comparaisons de chaines qui ne tiennent pas compte de la casse des 
caracteres. Cette fonction s'utilise comme la fonction strcmp, qui compare deux chaines et ren- 
voie un entier dont le signe indique si la premiere chaine est plus petite ou plus grande que la 
deuxieme. Ces fonctions renvoient si les deux chaines sont strictement egales. Si vous desirez 
en savoir plus sur les fonctions de manipulation de chaines de la bibliotheque C, veuillez vous 
referer a la bibliographie. 



Pour finir, sachez que les conteneurs associatifs disposent d'une methode count qui renvoie le 
nombre d' elements du conteneur dont la clef est egale a la valeur passee en premier parametre. Cette 
methode retourne done une valeur du type size_type du conteneur, valeur qui peut valoir ou 1 pour 
les conteneurs a clefs uniques et n'importe quelle valeur pour les conteneurs a clefs multiples. La 
complexite de cette methode est in (N) +n, ou N est le nombre d'elements stockes dans le conteneur 
et n est le nombre d'elements dont la clef est egale a la valeur passee en parametre. Le premier terme 
provient en effet de la recherche du premier element disposant de cette propriete, et le deuxieme des 
comparaisons qui suivent pour compter les elements designes par la clef. 

Note : Les implementations de la bibliotheque standard utilisent generalement la structure de 
donnees des arbres rouges et noirs pour implementer les conteneurs associatifs. Cette structure 
algorithmique est une forme d'arbre binaire equilibre, dont la hauteur est au plus le logarithme 
binaire du nombre d'elements contenus. Ceci explique les performances des conteneurs associ- 
atifs sur les operations de recherche. 
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La plupart des operations qui peuvent etre appliquees aux structures de donnees ne sont pas speci- 
fiques a ces structures. Par exemple, il est possible de trier quasiment toutes les sequences, que ce 
soient des listes, des vecteurs ou des deques. Les classes template des conteneurs de la bibliotheque 
standard ne fournissent done que des methodes de base permettant de les manipuler, et rares sont les 
conteneurs qui definissent des operations dont le role depasse le simple cadre de 1'ajout, de la sup- 
pression ou de la recherche d'elements. Au lieu de cela, la bibliotheque standard definit tout un jeu de 
fonctions template exterieures aux conteneurs et dont le but est de realiser ces operations de haut 
niveau. Ces fonctions sont appelees algorithmes en raison du fait qu'elles effectuent les traitements 
des algorithmes les plus connus et les plus utilises en informatique. 

Les algorithmes ne derogent pas a la regie de genericite que la bibliotheque standard C++ s'impose. 
Autrement dit, ils sont capables de travailler en faisant le moins d'hypotheses possibles sur la structure 
de donnees contenant les objets sur lesquels ils s'appliquent. Ainsi, tous les algorithmes sont des 
fonctions template et ils travaillent sur les objets exclusivement par 1' intermediate d'iterateurs et 
de foncteurs. Cela signifie que les algorithmes peuvent, en pratique, etre utilises sur n'importe quelle 
structure de donnees ou n'importe quel conteneur, pourvu que les preconditions imposees sur les 
iterateurs et le type des donnees manipulees soient respectees. 

Comme pour les methodes permettant de manipuler les conteneurs, les algorithmes sont decrits par 
leur semantique et par leur complexite. Cela signifie que les implementations de la bibliotheque stan- 
dard sont libres quant a la maniere de realiser ces algorithmes, mais qu'elles doivent imperativement 
respecter les contraintes de performances imposees par la norme de la bibliotheque standard. En pra- 
tique cependant, tout comme pour les structures de donnees des conteneurs, ces contraintes imposent 
souvent l'algorithme sous-jacent pour 1' implementation de ces fonctionnalites et l'algorithme utilise 
est le meilleur algorithme connu a ce jour. Autrement dit, les algorithmes de la bibliotheque standard 
sont forcement les plus efficaces qui soient. 

La plupart des algorithmes de la bibliotheque standard sont declares dans l'en-tete algorithm. Cer- 
tains algorithmes ont ete toutefois definis initialement pour les valarray et n'apparaissent done pas 
dans cet en-tete. Au lieu de cela, ils sont declares dans l'en-tete numeric. Ces algorithmes sont peu 
nombreux et cette particularite sera signalee dans leur description. 

Le nombre des algorithmes definis par la bibliotheque standard est impressionnant et couvre sans 
doute tous les besoins courants des programmeurs. II est done difficile, en raison de cette grande diver- 
site, de presenter les algorithmes de maniere structuree. Cependant, les sections suivantes regroupent 
ces algorithmes en fonction de la nature des operations qu'ils sont supposes effectuer. Ces operations 
comprennent les operations de manipulation generales des donnees, les recherches d'elements selon 
des criteres particuliers, les operations de tri et de comparaison, et enfin les operations de manipulation 
ensemblistes. 



18.1. Operations generales de manipulation des donnees 

Les algorithmes generaux de manipulation des donnees permettent de realiser toutes les operations 
classiques de type creation, copie, suppression et remplacement, mais egalement de modifier 1'ordre 
des sequences d'elements ainsi que d'appliquer un traitement sur chacun des elements des conteneurs. 

Certains algorithmes peuvent modifier soit les donnees contenues par les conteneurs sur lesquels ils 
travaillent, soit les conteneurs eux-memes. En general ces algorithmes travaillent sur place, e'est a 
dire qu'ils modifient les donnees du conteneur directement. Cependant, pour certains algorithmes, il 
est possible de stocker les donnees modifiees dans un autre conteneur. Le conteneur source n'est done 
pas modifie et les donnees, modifiees ou non, sont copiees dans le conteneur destination. En general, 



385 



Chapitre 18. Les algorithm.es 



les versions des algorithmes capables de faire cette copie a la volee ne sont fournies que pour les 
algorithmes peu complexes car le cout de la copie peut dans ce cas etre aussi grand ou plus grand que 
le cout du traitement des algorithmes eux-memes. II est done justifie pour ces algorithmes de donner la 
possibilite de realiser la copie pendant leur traitement afin de permettre aux programmes d'optimiser 
les programmes selon les cas d' utilisation. Le nom des algorithmes qui realisent une copie a la volee 
est le meme nom que leur algorithme de base, mais suffixe par le mot « _copy ». 

18.1.1. Operations d'initialisation et de remplissage 

II existe deux methodes permettant d' initialiser un conteneur ou de generer une serie d'objets pour 
initialiser un conteneur. La premiere methode ne permet que de generer plusieurs copies d'un meme 
objet, que Ton specifie par valeur, alors que la deuxieme permet d'appeler une fonction de generation 
pour chaque objet a creer. 

Les algorithmes de generation et d'initialisation sont declares de la maniere suivante dans l'en-tete 

algorithm : 

template <class Forwarlterator, class T> 

void fill (Forwardlterator premier, Forwardlterator dernier, const T Svaleur) 

template <class Outputlterator, class T> 

void fill_n (Output Iterator premier, Size nombre, const T Svaleur) ; 

tempalte <class Forwardlterator, class T, class Generator> 

void generate (Forwardlterator premier, Forwardlterator dernier, Generator g) 

template <class Outputlterator, class T, class Generator> 

void generate_n (Output Iterator premier, Size nombre, Generator g) ; 



Chaque algorithme est disponible sous deux formes differentes. La premiere utilise un couple 
d'iterateurs referencant le premier et le dernier element a initialiser, et la deuxieme n' utilise qu'un 
iterateur sur le premier element et le nombre d'elements a generer. Le dernier parametre permet de 
preciser la valeur a affecter aux elements du conteneur cible pour les algorithmes fill et f ill_n, 
ou un foncteur permettant d'obtenir une nouvelle valeur a chaque invocation. Ce foncteur ne prend 
aucun parametre et renvoie la nouvelle valeur de 1' objet. 

Exemple 18-1. Algorithme de generation d'objets et de remplissage d'un conteneur 

#include <iostream> 
#include <list> 
#include <iterator> 
#include <algorithm> 

using namespace std; 

int compte ( ) 
{ 

static int i = 0; 

return i++; 
} 

int main (void) 
{ 

// Cree une liste de 20 entiers consecutifs : 
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typedef list<int> li; 

li 1; 

generate_n (back_inserter (1) , 20, compte) ; 

// Affiche la liste : 

li::iterator i = l.begin(); 

while (i != 1 . end ( ) ) 

{ 

cout << *i << endl; 

+ + i; 

} 

return 0; 



} 



Ces algorithmes effectuent exactement autant d' affectations qu'il y a d'elements a creer ou a initiali- 
ser. Leur complexite est done lineaire en fonction du nombre de ces elements. 



18.1.2. Operations de copie 

La bibliotheque standard definit deux algorithmes fondamentaux pour realiser la copie des donnees 
des conteneurs. Ces algorithmes sont declares comme suit dans l'en-tete algorithm : 

template <class Inputlterator, class Outputlterator> 
Output Iterator copy (Inputlterator premier, Inputlterator dernier, 
Outputlterator destination) ; 

template <class Bidirectionallteratorl, class BidirectionalIterator2> 
BidirectionalIterator2 copy_backward ( 

Bidirectionallteratorl premier, Bidirectionallteratorl dernier, 

BidirectionalIterator2 f in_destination) ; 



Alors que copy realise la copie des objets references par les iterateurs premier et dernier du pre- 
mier vers le dernier, l'algorithme backward_copy travaille dans le sens contraire. On utilisera done 
typiquement backward_copy a chaque fois que la zone memoire destination empiete sur la fin des 
donnees sources. Notez que dans ce cas, l'iterateur specifiant la destination reference le dernier empla- 
cement utilise apres la copie et non le premier element. Autrement dit, l'iterateur f in_destination 
est utilise de maniere descendante, alors que l'iterateur destination fourni a l'algorithme copy est 
utilise de maniere ascendante. 

Exemple 18-2. Algorithme de copie inverse 

#include <iostream> 
tinclude <algorithm> 
tinclude <cstring> 

using namespace std; 

int main (void) 
{ 

char sBuffer[] = "abedef gl23 " ; 

// Determine l'iterateur de fin : 

char *pFin = sBuffer + strlen (sBuf f er) ; 

// Ecrase la chaine par elle-meme a partir du ' d' : 

copy_backward (sBuf f er , pFin-3, pFin) ; 

// Affiche le resultat : 
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cout << sBuffer << endl; 
return ; 



Note : La fonction strien utilisee dans cet exemple est une des fonctions de la bibliotheque 
C standard, qui est declaree dans I'en-tete cstring. Elle permet de calculer la longueur d'une 
chaine de caracteres C (sans compter le caratere nul terminal). 



Ces algorithmes effectuent exactement autant d' affectation qu'il y a d' elements a copier. Leur com- 
plexite est done lineaire en fonction du nombre de ces elements. 

Note : II existe egalement des algorithmes capables de realiser une copie de leur resultat a la 
volee. Le nom de ces algorithmes est generalement le nom de leur algorithme de base suffixe 
par la chaine _copy. Ces algorithmes seront decrits avec leurs algorithmes de base. 



18.1.3. Operations d'echange d'elements 

II est possible d'echanger le contenu de deux sequences d'elements grace a un algorithme dedie a cette 
tache, l'algorithme swap_ranges. Cet algorithme est declare comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class ForwardIterator2> 

ForwardIterator2 swap_ranges (Forwardlterator premier, Forwardlterator dernier, 
ForwardIterator2 destination) ; 



Cet algorithme prend en parametre les deux iterateurs definissant la premiere sequence et un iterateur 
destination permettant d'indiquer le premier element de la deuxieme sequence avec les elements de 
laquelle l'echange doit etre fait. La valeur retournee est l'iterateur de fin de cette sequence, une fois 
F operation terminee. 

Exemple 18-3. Algorithme d'echange 

#include <iostream> 
#include <list> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

// Definit une liste d'entiers : 

typedef list<int> li; 

li 1; 

1 .push_back (2 ) ; 

1 .push_back (5) ; 

1 .push_back (3) ; 

1 .push_back (7 ) ; 

// Definit un tableau de quatre elements : 

int t [4] = {10, 11, 12, 13}; 

// Echange le contenu du tableau et de la liste : 

swap_ranges (t, t + 4, 1. begin ()); 
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II Affiche le tableau : 

int i; 

for (i=0; i<4; ++i) 

cout << t[i] << " "; 
cout << endl; 
// Affiche la liste : 
li::iterator it = l.beginO; 
while (it != 1 . end ( ) ) 
{ 

cout << *it << " "; 

+ + it; 
} 

cout << endl; 
return 0; 



} 



Cet algorithme n'echange pas plus d'elements que necessaire, autrement dit, il a une complexite 
lineaire en fonction de la taille de la sequence initiale. 



18.1.4. Operations de suppression d'elements 

Les conteneurs de la bibliotheque standard disposent tous de methodes puissantes permettant 
d'effectuer des suppressions d'elements selon differents criteres. Toutefois, la bibliotheque standard 
definit egalement des algorithmes de suppression d'elements dans des sequences. En fait, ces 
algorithmes n'effectuent pas a proprement parler de suppression, mais une reecriture des sequences 
au cours de laquelle les elements a supprimer sont tout simplement ignores. Ces algorithmes 
renvoient done l'iterateur du dernier element copie, au-dela duquel la sequence initiale est inchangee. 

La bibliotheque standard fournit egalement des versions de ces algorithmes capables de realiser une 
copie a la volee des elements de la sequence resultat. Ces algorithmes peuvent done typiquement 
etre utilises pour effectuer un filtre sur des elements dont le but serait de supprimer les elements 
indesirables. 

Les fonctions de suppression des elements sont declarees comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class T> 

Forwardlterator remove (Forwardlterator premier, Forwardlterator second, 
const T Svaleur) ; 

template <class Inputlterator, class Outputlterator, class T> 
Output Iterator remove_copy (Inputlterator premier, Inputlterator second, 
Outputlterator destination, const T Svaleur) ; 

template <class Forwardlterator, class Predicate> 

Forwardlterator remove_if (Forwardlterator premier, Forwardlterator second, 
Predicate p) ; 

template <class Inputlterator, class Outputlterator, class Predicate> 
Outputlterator remove_copy_if (Inputlterator premier, Inputlterator second, 
Outputlterator destination, Predicate p) ; 



Toutes ces fonctions prennent en premier et en deuxieme parametre les iterateurs definissant 
l'intervalle d'elements sur lequel elles doivent travailler. Pour les fonctions de suppression d'un 
element particulier, la valeur de cet element doit egalement etre fournie. Si vous preferez utiliser les 
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versions basees sur un predicat, il vous faut specifier un foncteur unaire prenant en parametre un 
element et renvoyant un booleen indiquant si cet element doit etre supprime ou non. Enfin, les 
versions de ces algorithmes permettant de realiser une copie a la volee necessitent bien entendu un 
iterateur supplemental indiquant l'emplacement destination ou les elements non supprimes devront 
etre stockes. 

Comme vous pouvez le constater d'apres leurs declarations, ces algorithmes renvoient tous un itera- 
teur referencant l'element suivant le dernier element de la sequence resultat. Cet iterateur permet de 
determiner la fin de la sequence d' elements resultat, que cette sequence ait ete modifiee sur place ou 
qu'une copie ait ete realisee. Si l'algorithme utilise n'effectue pas de copie, les elements suivant cet 
iterateur sont les elements de la sequence initiale. C'est a ce niveau que la difference entre les algo- 
rithmes de suppression et les methodes erase des conteneurs (et les methodes remove des listes) 
apparait : les algorithmes ecrasent les elements supprimes par les elements qui les suivent, mais ne 
suppriment pas les elements source du conteneur situes au-dela de l'iterateur renvoye, alors que les 
methodes erase des conteneurs suppriment effectivement des conteneurs les elements a eliminer. 

Exemple 18-4. Algorithme de suppression 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

// Construit un tableau de 10 entiers : 

int t[10] = { 1, 2, 2, 3, 5, 2, 4, 3, 6, 7 }; 

// Supprime les entiers valant 2 : 

int *fin = remove (t, t+10, 2); 

// Affiche le tableau resultat : 

int *p = t; 

while (p != fin) 

{ 

cout << *p << endl; 

++p; 



return 0; 



} 



De maniere similaire, la bibliotheque standard definit egalement des algorithmes permettant de sup- 
primer les doublons dans des sequences d'elements. Ces algorithmes sont declares comme suit dans 
l'en-tete algorithm : 

template<class ForwardIterator> 

Forwardlterator unique (Forwardlterator premier, Forwardlterator dernier) ; 

template<class Forwardlterator, class Outputlterator> 

Output Iterator unique_copy (Forwardlterator premier, Forwardlterator dernier); 

template <class Forwardlterator, class BinaryPredicate> 

Forwardlterator unique (Forwardlterator premier, Forwardlterator dernier, 
BinaryPredicate p) ; 

template <class Forwardlterator, class Outputlterator, class BinaryPredicate> 
Output Iterator unique_copy (Forwardlterator premier, Forwardlterator dernier, 
BinaryPredicate p) ; 
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Ces algorithmes fonctionnent de la meme maniere que les algorithmes remove a ceci pres qu'ils 
n'eliminent que les doublons dans la sequence source. Cela signifie qu'il n'est pas necessaire de 
preciser la valeur des elements a eliminer d'une part et, d' autre part, que les predicats utilises sont des 
predicats binaires puisqu'ils doivent etre appliques aux couples d' elements successifs. 

Note : II n'existe pas d'algorithmes unique_if et unique_copy_if. La bibliotheque standard 
utilise les possibilites de surcharge du C++ pour distinguer les versions avec et sans predicat des 
algorithmes de suppression des doublons. 



Exemple 18-5. Algorithme de suppression des doublons 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

// Construit un tableau de 10 entiers : 

int t[10] = { 1, 2, 2, 3, 5, 2, 4, 3, 6, 7 }; 

// Supprime les doublons : 

int *fin = unique (t, t + 10); 

// Affiche le tableau resultat : 

int *p = t; 

while (p != fin) 

{ 

cout << *p << endl; 

++p; 
} 
return 0; 



Le test de suppression est applique par ces algorithmes autant de fois qu'il y a d' elements dans la 
sequence initiale, c'est-a-dire que leur complexite est lineaire en fonction du nombre d'elements de 
cette sequence. 



18.1.5. Operations de remplacement 

Les algorithmes de remplacement permettent de remplacer tous les elements d'un conteneur verifiant 
une propriete particuliere par un autre element dont la valeur doit etre fournie en parametre. Les 
elements devant etre remplaces peuvent etre identifies soit par leur valeur, soit par un predicat unaire 
prenant en parametre un element et renvoyant un booleen indiquant si cet element doit etre remplace 
ou non. Les algorithmes de remplacement sont declares comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class T> 

void replace (Forwardlterator premier, Forwardlterator dernier, 
const T &ancienne_valeur , const T &nouvelle_valeur ) ; 

template <class Inputlterator, class Outputlterator, class T> 
void replace_copy ( Input Iterator premier, Inputlterator dernier, 
Outputlterator destination, 
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const T &ancienne_valeur , const T &nouvelle_valeur ) ; 

template <class Forwardlterator, class Predicate, class T> 
void replace_if (Forwardlterator premier, Forwardlterator dernier, 
Predicate p, const T &nouvelle_valeur) ; 

template <class Inputlterator, class Outputlterator, 

class Predicate, class T> 
void replace_copy_if ( Inputlterator premier, Inputlterator dernier, 

Outputlterator destination, 

Predicate p, const T &nouvelle_valeur) ; 



Les algorithmes de remplacement peuvent travailler sur place ou effectuer une copie a la volee des 
elements sur lesquels ils travaillent. Les versions capables de realiser ces copies sont identifiees par 
le suffixe _copy de leur nom. Ces algorithmes prennent un parametre supplementaire permettant de 
specifier l'emplacement destination ou les elements copies devront etre stockes. Ce parametre est un 
iterateur, tout comme les parametres qui indiquent l'intervalle d'elements dans lequel la recherche et 
le remplacement doivent etre realises. 

Exemple 18-6. Algorithme de recherche et de remplacement 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {1, 2, 5, 3, 2, 7, 6, 4, 2, 1}; 

// Remplace tous les 2 par des 9 : 

replace (t, t + 10, 2, 9); 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

cout << t[i] << endl; 

return ; 
} 

Le test de remplacement est applique par ces algorithmes autant de fois qu'il y a des elements dans la 
sequence initiale, c'est-a-dire que leur complexite est lineaire en fonction du nombre d'elements de 
cette sequence. 



18.1.6. Reorganisation de sequences 

Comme il Fa ete explique dans la Section 17.2, l'ordre des elements d'une sequence est important. 
La plupart des sequences conservent les elements dans l'ordre dans lequel ils ont ete inseres, d' autre 
se reorganised automatiquement lorsque Ton travaille dessus pour assurer un ordre bien defini. 

La bibliotheque standard fournit plusieurs algorithmes permettant de reorganiser la sequence des ele- 
ments dans un conteneur qui ne prend pas en charge lui-meme l'ordre de ses elements. Ces algo- 
rithmes permettent de realiser des rotations et des permutations des elements, des symetries et des 
inversions, ainsi que de les melanger de maniere aleatoire. 
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Note : II existe egalement des algorithmes de tri extremement efficaces, mais ces algorithmes 
seront decrits plus loin dans une section qui leur est consacree. 



18.1.6.1. Operations de rotation et de permutation 

Les algorithmes de rotation permettent de faire tourner les differents elements d'une sequence dans un 
sens ou dans 1' autre. Par exemple, dans une rotation vers la gauche d'une place, le deuxieme element 
peut prendre la place du premier, le troisieme celle du deuxieme, etc., le premier element revenant a 
la place du dernier. Ces algorithmes sont declares de la maniere suivante dans l'en-tete algorithm : 

template <class ForwardIterator> 

void rotate (Forwardlterator premier, Forwardlterator pivot, 
Forwardlterator dernier) ; 

template <class Forwardlterator, class Outputlterator> 
void rotate_copy (Forwardlterator premier, Forwardlterator pivot, 
Forwardlterator dernier, Output Iterator destination); 



Les algorithmes de rotation prennent en parametre un iterateur indiquant le premier element de la se- 
quence devant subir la rotation, un iterateur referencant 1' element qui se trouvera en premiere position 
apres la rotation, et un iterateur referencant l'element suivant le dernier element de la sequence. Ainsi, 
pour effectuer une rotation d'une position vers la gauche, il suffit d'utiliser pour l'iterateur pivot la 
valeur de l'iterateur suivant l'iterateur premier et, pour effectuer une rotation d'une position vers la 
droite, il faut prendre pour l'iterateur pivot la valeur precedant celle de l'iterateur dernier. 

Exemple 18-7. Algorithme de rotation 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; 

// Effectue une rotation pour amener le quatrieme 

// element en premiere position : 

rotate (t, t + 3, t + 10); 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

cout << t[i] << endl; 

return 0; 
} 

La bibliotheque fournit egalement des algorithmes permettant d'obtenir 1' ensemble des permutations 
d'une sequence d'elements. Rappelons qu'une permutation est une des combinaisons possibles des 
valeurs des differents elements d'un ensemble, en considerant les elements d'egale valeur comme 
identiques. Par exemple, si un ensemble contient deux elements de meme valeur, il n'y a qu'une seule 
permutation possible : les deux valeurs. Si en revanche ces deux elements ont deux valeurs distinctes, 
on peut realiser deux permutations selon la valeur que Ton place en premier. 
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Les algorithmes de permutation de la bibliotheque ne permettent pas d'obtenir les permutations di- 
rectement. Au lieu de cela, ils permettent de passer d'une permutation a la permutation suivante ou a 
la precedente. Cela suppose qu'une relation d'ordre soit definie sur l'ensemble des permutations de 
la sequence. La bibliotheque standard utilise l'ordre lexicographique pour classer ces permutations. 
Autrement dit, les premieres permutations sont celles pour lesquelles les premiers elements ont les 
valeurs les plus faibles. 

Les algorithmes de calcul des permutations suivante et precedente sont declares comme suit dans 
l'en-tete algorithm : 

template <class BidirectionalIterator> 

bool next_permutation (Bidirectionallterator premier, Bidirectionallterator dernier) 

template <class BidirectionalIterator> 

bool prev_permutation (Bidirectionallterator premier, Bidirectionallterator der- 
nier) ; 



Ces algorithmes prennent tous les deux deux iterateurs indiquant les elements devant subir la permu- 
tation et renvoient un booleen indiquant si la permutation suivante ou precedente existe ou non. Si ces 
permutations n'existent pas, les algorithmes next_permutation et prev_permutation bouclent 
et calculent respectivement la plus petite et la plus grande permutation de l'ensemble des permuta- 
tions. 

Exemple 18-8. Algorithme de permutation 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t [3] = {1, 1, 2}; 

// Affiche l'ensemble des permutations de (1, 1, 2) : 

do 

{ 

int i; 

for (i=0; i<3; ++i) 

cout << t [i] << " "; 
cout << endl; 
} 

while (next_permutation (t , t+3)); 
return 0; 



Les algorithmes de rotation effectuent autant d'echange qu'il y a d' elements dans la sequence initiale, 
et les algorithmes de calcul de permutation en font exactement la moitie. La complexite de ces algo- 
rithmes est done lineaire en fonction du nombre d'elements de l'intervalle qui doit subir l'operation. 
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18.1.6.2. Operations d'inversion 



II est possible d'inverser l'ordre des elements d'une sequence a l'aide des algorithmes reverse et 
reverse_copy. Ces algorithmes sont declares de la maniere suivante dans l'en-tete algorithm : 

template <class BidirectionalIterator> 

void reverse (Bidirectionallterator premier, Bidirectionallterator dernier) ; 

template <class Bidirectionallterator, class Outputlterator> 
Output Iterator reverse_copy (Bidirectionallterator premier, 

Bidirectionallterator dernier, Outputlterator destination) ; 



Ces algorithmes prennent en parametre les iterateurs permettant de specifier l'intervalle des elements 
qui doit etre inverse. La version de cet algorithme qui permet de realiser une copie prend un parametre 
supplemental qui doit recevoir l'iterateur referencant 1'emplacement destination dans lequel le re- 
sultat de 1'inversion doit etre stocke. Cet iterateur retourne la valeur de l'iterateur destination passe le 
dernier element ecrit. 

Exemple 18-9. Algorithme d'inversion 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; 

// Inverse le tableau : 

reverse (t , t + 10) ; 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

cout << t[i] << endl; 

return 0; 
} 

Les algorithmes d'inversion effectuent autant d'echange d' elements qu'il y en a dans la sequence 
initiale. Autrement dit, leur complexite est lineaire en fonction de la taille de cette sequence. 



18.1.6.3. Operations de melange 

II est possible de redistribuer aleatoirement les elements d'une sequence a l'aide de 1' algorithme 
random_shuf f le. Cet algorithme est fourni sous la forme de deux surcharges declarees comme suit 
dans l'en-tete algorithm : 

template <class RandomAccessIterator> 

void random_shuf f le (RandomAccessIterator premier, RandomAccessIterator dernier) 

template <class RandomAccessIterator, class RandomNumberGenerator> 
void random_shuf f le (RandomAccessIterator premier, RandomAccessIterator dernier, 
RandomNumberGenerator g) ; 
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Ces algorithmes prennent en parametre les iterateurs de debut et de fin de la sequence dont les ele- 
ments doivent etre melanges. La deuxieme version de cet algorithme peut prendre en dernier para- 
metre un foncteur qui sera utilise pour calculer les positions des elements pendant le melange. Ainsi, 
cette surcharge permet de specifier soi-meme la fonction de distribution a utiliser pour effectuer cette 
nouvelle repartition. Ce foncteur doit prendre en parametre une valeur du type difference_type des 
iterateurs utilises pour referencer les elements de la sequence, et renvoyer une valeur comprise entre 
et la valeur recue en parametre. II doit done se comporter comme la fonction rand de la bibliotheque 
standard C (declaree dans le fichier d'en-tete cstdlib). 

Exemple 18-10. Algorithme de melange 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; 

// Melange le tableau t : 

random_shuf f le (t , t+10); 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

cout << t[i] << endl; 

return ; 



Ces algorithmes effectuent exactement le nombre d' elements de la sequence a melanger moins un 
echanges de valeurs. Leur complexite est done lineaire en fonction du nombre d'elements de ces 
sequences. 



18.1.7. Algorithmes a" iteration et de transformation 

Les algorithmes de transformation et d' iteration de la bibliotheque standard font partie des plus utiles 
puisqu'ils permettent d' effectuer un traitement sur 1' ensemble des elements d'un conteneur. Ces trai- 
tements peuvent modifier ou non ces elements ou tout simplement calculer une valeur a partir de ces 
elements. 

Les deux principaux algorithmes fournis par la bibliotheque standard sont sans doute les algorithmes 
f or_each et transform, qui permettent d' effectuer une action sur chaque element d'un conteneur. 
Ces algorithmes sont declares comme suit dans l'en-tete algorithm : 

template <class Inputlterator, class Function> 

Function for_each ( Inputlterator premier, Inputlterator dernier, Function f ) ; 

template <class Inputlterator, class Outputlterator, 

class UnaryOperation> 
Outputlterator transform (Inputlterator premier, Inputlterator dernier, 

Outputlterator destination, UnaryOperation op) ; 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator, class BinaryOperation> 
Outputlterator transform (Inputlteratorl premierl, Inputlteratorl dernierl, 
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InputIterator2 premier2, Output Iterator destination, 
BinaryOperation op) ; 



L'algorithme f or_each permet d' iterer les elements d'un conteneur et d'appeler une fonction pour 
chacun de ces elements. II prend done en parametre deux iterateurs permettant de specifier les ele- 
ments a iterer et un foncteur qui sera appele a chaque iteration. Pendant 1'iteration, ce foncteur recoit 
en parametre la valeur de l'element de l'iteration courante de la part de f or_each. Cette valeur ne 
doit en aucun cas etre modifiee et la valeur retournee par ce foncteur est ignoree. La valeur retournee 
par l'algorithme f or_each est le foncteur qui lui a ete communique en parametre. 

Contrairement a for_each, qui ne permet pas de modifier les elements qu'il itere, l'algorithme 
transform autorise la modification des elements du conteneur sur lequel il travaille. II est fourni 
sous deux versions, la premiere permettant d'appliquer un foncteur unaire sur chaque element d'un 
conteneur et la deuxieme un foncteur binaire sur deux elements de deux conteneurs sur lesquels 
l'algorithme itere simultanement. Les deux versions prennent en premiers parametres les iterateurs 
permettant de specifier les elements a iterer du premier conteneur. lis prennent egalement en para- 
metre un foncteur permettant de calculer une nouvelle valeur a partir des elements iteres et un itera- 
teur dans lequel les resultats de ce foncteur seront stockes. La version permettant de travailler avec 
un foncteur binaire prend un parametre complementaire, qui doit recevoir la valeur de l'iterateur de 
debut du conteneur devant fournir les elements utilises en tant que second operande du foncteur. La 
valeur retournee par les algorithmes transform est la valeur de fin de l'iterateur destination. 

Exemple 18-11. Algorithmes d'iteration 

#include <iostream> 
#include <functional> 
#include <algorithm> 

using namespace std; 

void af f_entier (int i) 
{ 

cout << i << endl; 



int main (void) 
{ 

int t[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; 

// Inverse tous les elements du tableau : 

transform(t, t + 10, t, negate<int> ( ) ) ; 

// Affiche le resultat : 

for_each(t, t+10, ptr_fun (Saf f_entier ) ) ; 

return 0; 
} 

Comme vous pouvez le constater d'apres cet exemple, il est tout a fait possible d'utiliser la meme 
valeur pour l'iterateur premier et l'iterateur destination. Cela signifie que les elements ite- 
res peuvent etre remplaces par les nouvelles valeurs calculees par le foncteur fourni a l'algorithme 

transform. 

Un cas particulier des algorithmes d'iteration est celui des algorithmes count et count_if puisque 
le traitement effectue est alors simplement le decompte des elements verifiant une certaine condition. 
Ces deux algorithmes permettent en effet de compter le nombre d' elements d'un conteneur dont la 
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valeur est egale a une valeur donnee ou verifiant un critere specifie par l'intermediaire d'un predicat 
unaire. Ces deux algorithmes sont declares de la maniere suivante dans l'en-tete algorithm : 

template <class Inputlterator, class T> 
iterator_traits<InputIterator> : : dif f erence_type 

count ( Input Iterator premier, Inputlterator dernier, const T Svaleur) ; 

template <class Inputlterator, class Predicate> 
iterator_traits<InputIterator> : : dif f erence_type 

count_if ( Input Iterator premier, Inputlterator dernier, Predicate p) ; 



Comme vous pouvez le constater, ces algorithmes prennent en parametre deux iterateurs specifiant 
l'intervalle des elements sur lesquels le test doit etre effectue, et la valeur avec laquelle ces elements 
doivent etre compares ou un predicat unaire. Dans ce cas, le resultat de ce predicat indique si l'element 
qu'il recoit en parametre doit etre compte ou non. 

Exemple 18-12. Algorithme de decompte d'elements 

#include <iostream> 
♦include <functional> 
♦include <algorithm> 

using namespace std; 

bool parity_even (int i) 

{ 

return (i & 1) == 0; 

} 

int main (void) 
{ 

int t[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; 

// Compte le nombre d'elements pairs : 

cout << count_if(t, t+10, ptr_f un ( &parity_even) ) << endl; 

return 0; 
} 

Tous les algorithmes d'iteration ne font qu'un seul passage sur chaque element itere. Autrement dit, la 
complexite de ces algorithmes est lineaire en fonction du nombre d'elements compris entre les deux 
iterateurs specifiant l'intervalle d'elements sur lequel ils sont appliques. 

Enfin, la bibliotheque standard fournit des algorithmes de calcul plus evolues, capables de travailler 
sur les elements des conteneurs. Ces algorithmes sont generalement utilises en calcul numerique et 
ont ete concus specialement pour les tableaux de valeurs. Cependant, ils restent tout a fait utilisables 
sur d'autres conteneurs que les valarray, la seule distinction qu'ils ont avec les autres algorithmes de la 
bibliotheque standard est qu'ils sont declares dans l'en-tete numeric au lieu de l'en-tete algorithm. 
Ces algorithmes sont les suivants : 

template <class Inputlterator, class T> 

T accumulate ( Input Iterator premier, Inputlterator dernier, T init); 

template <class Inputlterator, class T, class BinaryOperation> 
T accumulate ( Inputlterator premier, Inputlterator dernier, 
T init, BinaryOperation op) ; 
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template <class Inputlteratorl, class InputIterator2, class T> 
T inner_product ( Input Iteratorl premierl, Inputlteratorl dernierl, 
Input Iterator2 premier2, T init); 

template <class Inputlteratorl, class InputIterator2, class T, 

class BinaryOperationl , class Binary0peration2> 
T inner_product ( Input Iteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, T init, 

BinaryOperationl opl, BinaryOperation op2); 

template <class Inputlterator, class Outputlterator> 

Output Iterator partial_sum (Inputlterator premier, Inputlterator dernier, 
Outputlterator destination) ; 

template <class Inputlterator, class Outputlterator, class BinaryOperation> 
Outputlterator partial_sum (Inputlterator premier, Inputlterator dernier, 
Outputlterator destination, BinaryOperation op) ; 

template <class Inputlterator, class Outputlterator> 

Outputlterator adjacent_dif f erence (Inputlterator premier, Inputlterator dernier, 
Outputlterator destination) ; 

template <class Inputlterator, class Outputlterator, class BinaryOperation> 
Outputlterator adjacent_diff erence (Inputlterator premier, Inputlterator dernier, 
Outputlterator destination, BinaryOperation op) ; 



Ces algorithmes correspondent a des operations courantes, que Ton fait generalement sur les tableaux 
de nombres de type valarray. L'algorithme accumulate permet generalement de realiser la somme 
des valeurs qui sont stockees dans un conteneur. L'algorithme inner_product est utilise quant a lui 
pour realiser le produit scalaire de deux sequences de nombres, operation mathematique generalement 
effectuee dans le calcul vectoriel. Enfin, les algorithmes partial_sum et adjacent_diff erence 
realisent respectivement le calcul des sommes partielles et des differences deux a deux des elements 
d'un conteneur. 

Pout tous ces algorithmes, il est possible d'utiliser d'autres operations que les operations genera- 
lement utilisees. Par exemple, accumulate peut utiliser une autre operation que l'addition pour 
« accumuler » les valeurs des elements. Pour cela, la bibliotheque standard fournit des surcharges 
de ces algorithmes capables de travailler avec des foncteurs binaires. Ces foncteurs doivent accep- 
ter deux parametres du type des elements du conteneur sur lequel les algorithmes sont appliques et 
renvoyer une valeur du meme type, calculee a partir de ces parametres. 

L'algorithme accumulate prend done en premiers parametres les iterateurs definissant l'intervalle 
des valeurs qui doivent etre accumulees. II initialise la valeur d'une variable accumulateur avec la 
valeur fournie en troisieme parametre, et parcours 1'ensemble des elements. Pour chaque element 
traite, accumulate remplace la valeur courante de 1' accumulateur par le resultat de 1' operation 
d' accumulation appliquee a 1' accumulateur lui-meme et a la valeur de 1' element courant. Par defaut, 
F operation d' accumulation utilisee est l'addition, mais il est possible de changer ce comportement en 
fournissant un foncteur binaire en dernier parametre. Lorsque 1'ensemble des elements a ete parcouru, 
la valeur de 1' accumulateur est retournee. 

Exemple 18-13. Algorithme d'accumulation 

#include <list> 
#include <numeric> 
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#include <functional> 
#include <iostream> 

using namespace std; 

int main (void) 
{ 

// Construit une liste d'entiers : 

typedef list<int> li; 

li 1; 

1 .push_back (5) ; 

1 .push_back (2 ) ; 

1 .push_back ( 9) ; 

1 .push_back (1) ; 

// Calcule le produit de ces entiers : 

int res = accumulate (1 .begin () , 1 . end ( ) 
1, multiplies<int> ( ) ) ; 

cout << res << endl; 

return 0; 



L'algorithme inner_product travaille sur deux conteneurs simultanement et realise leur produit 
scalaire. Le produit scalaire est 1' operation qui consiste a multiplier les elements de deux series de 
nombres deux a deux, et de faire la somme des resultats. L'algorithme inner_product prend done en 
parametre les iterateurs de debut et de fin specifiant la premiere serie de nombres, l'iterateur de debut 
de la deuxieme serie de nombres, et la valeur initiale de l'accumulateur utilise pour realiser la somme 
des produits des elements de ces deux conteneurs. Bien entendu, tout comme pour l'algorithme ac- 
cumulate, il est possible de remplacer les operations de multiplication et d'addition de l'algorithme 
standard par deux foncteurs en fournissant ceux-ci en derniers parametres. 

Exemple 18-14. Algorithme de produit scalaire 

#include <iostream> 
#include <numeric> 

using namespace std; 

int main (void) 
{ 

// Definit deux vecteurs orthogonaux : 

int tl [3] = {0, 1, 0}; 

int t2 [3] = {0, 0, 1}; 

// Calcule leur produit scalaire : 

int res = inner_product (tl , tl+3, t2, 0); 

// Le produit scalaire de deux vecteurs orthogonaux 

// est toujours nul : 

cout << res << endl; 

return 0; 
} 

L'algorithme partial_sum permet de calculer la serie des sommes partielles de la suite de valeurs 
specifiee par les deux iterateurs fournis en premiers parametres. Cette serie de sommes contiendra 
d'abord la valeur du premier element, puis la valeur de la somme des deux premiers elements, puis la 
valeur de la somme des trois premiers elements, etc., et enfin la somme de l'ensemble des elements de 
la suite de valeurs sur laquelle l'algorithme travaille. Toutes ces valeurs sont stockees successivement 
aux emplacements indiques par l'iterateur destination. Comme pour les autres algorithmes, il est 
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possible de specifier une autre operation que l'addition a l'aide d'un foncteur binaire que l'on passera 
en dernier parametre. 

Enfin, l'algorithme adjacent_dif ference est l'algorithme inverse de l'algorithme parial_sum. 
En effet, il permet de calculer la serie des differences des valeurs des elements successifs d'une suite 
de valeurs, pris deux a deux. Cet algorithme prend en parametre les iterateurs decrivant la suite de 
valeurs sur laquelle il doit travailler, l'iterateur de l'emplacement destination ou les resultats devront 
etre stockes et eventuellement le foncteur a appliquer aux couples d' elements successifs traites par 
l'algorithme. La premiere difference est calculee en supposant que l'element precedent le premier 
element a pour valeur la valeur nulle. Ainsi, le premier element de l'emplacement destination est 
toujours egal au premier element de la suite de valeurs sur laquelle l'algorithme travaille. 

Exemple 18-15. Algorithmes de sommes partielles et de differences adjacentes 

#include <iostream> 
#include <numeric> 

using namespace std; 

int main (void) 
{ 

int t [4] = {1, 1, 1, 1}; 

// Calcule les sommes partielles des elements 

// du tableau : 

partial_sum (t, t+4, t ) ; 

// Affiche le resultat : 

int i; 

for (i=0; i<4; ++i) 

cout << t[i] << " "; 
cout << endl; 

// Calcule les differences adjacentes : 
adjacent_dif ference (t, t+4, t); 
// C est le tableau initial : 
for (i=0; i<4; ++i) 

cout << t[i] << " "; 
cout << endl; 
return 0; 



Tous ces algorithmes travaillent en une seule passe sur les elements des conteneurs sur lesquels ils 
s'appliquent. Leur complexite est done lineaire en fonction du nombre d'elements specifies par les 
iterateurs fournis en premier parametre. 



18.2. Operations de recherche 



En general, la plupart des operations de recherche de motifs que les programmes sont susceptibles 
d'effectuer se font sur des chaines de caracteres ou sur les conteneurs associatifs. Cependant, il peut 
etre necessaire de rechercher un element dans un conteneur selon un critere particulier ou de re- 
chercher une sequence d'elements constituant un motif a retrouver dans la suite des elements d'un 
conteneur. Enfin, il est relativement courant d' avoir a rechercher les groupes d'elements consecutifs 
disposant de la meme valeur dans un conteneur. Toutes ces operations peuvent etre realisees a l'aide 
des algorithmes de recherche que la bibliotheque standard met a la disposition des programmeurs. 
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18.2.1. Operation de recherche d elements 

Le premier groupe d' operations de recherche contient tous les algorithmes permettant de retrouver 
un element dans un conteneur, en l'identifiant soit par sa valeur, soit par une propriete particuliere. 
Toutefois, cet element peut ne pas etre le seul element verifiant ce critere. La bibliotheque standard 
definit done plusieurs algorithmes permettant de rechercher ces elements de differentes manieres, 
facilitant ainsi les operations de recherche dans differents contextes. 

Les algorithmes de recherche d'elements sont les algorithmes find et find_if, qui permettent 
de retrouver le premier element d'un conteneur verifiant une propriete particuliere, et l'algorithme 
f ind_f irst_of, qui permet de retrouver le premier element verifiant une relation avec une valeur 
parmi un ensemble de valeurs donnees. Tous ces algorithmes sont declares dans l'en-tete algorithm : 

template <class Inputlterator, class T> 

Inputlterator find ( Inputlterator premier, Inputlterator dernier, const T Svaleur) 

template <class Inputlterator, class Predicate> 

Inputlterator find_if ( Input Iterator premier, Inputlterator dernier, Predicate p) ; 

template <class Inputlterator, class ForwardIterator> 

Inputlterator find_f irst_of ( Input Iterator premierl, Inputlterator dernierl, 
Forwardlterator premier2, Forwardlterator dernier2); 

template <class Inputlterator, class Forwardlterator, class BinaryPredicate> 
Inputlterator find_f irst_of ( Input Iterator premierl, Inputlterator dernierl, 

Forwardlterator premier2, Forwardlterator dernier2, 

BinaryPredicate p) ; 



L'algorithme find prend en parametre les deux iterateurs classiques definissant la sequence 
d'elements dans laquelle la recherche doit etre effectuee. II prend egalement en parametre la valeur 
de 1' element recherche, et renvoie un iterateur sur le premier element qui dispose de cette valeur. Si 
vous desirez effectuer une recherche sur un autre critere que l'egalite des valeurs, vous devez utiliser 
l'algorithme find_if. Celui-ci prend un predicat en parametre a la place de la valeur. C'est la 
valeur de ce predicat, applique a l'element courant dans le parcours des elements de la sequence 
definie par les iterateurs premier et dernier, qui permettra de determiner si cet element est celui 
recherche ou non. La valeur retournee est l'iterateur dernier si aucun element ne correspond au 
critere de recherche. La complexite de cet algorithme est lineaire en fonction du nombre d'elements 
de la sequence d'elements dans laquelle la recherche se fait. 

L'algorithme find_f irst_of prend deux couples d'iterateurs en parametre. Le premier definit 
l'intervalle d'elements dans lequel la recherche doit etre effectuee et le deuxieme un ensemble de 
valeur dont les elements doivent etre recherches. L'algorithme renvoie un iterateur sur le premier 
element qui est egal a 1'une des valeurs de l'ensemble de valeurs specifie par le deuxieme couple 
d'iterateurs, ou l'iterateur dernierl si cet element n'existe pas. II est egalement possible d' utiliser 
un autre critere que l'egalite avec l'un des elements de cet ensemble en utilisant un predicat binaire 
dont la valeur indiquera si l'element courant verifie le critere de recherche. Lorsqu'il est appele par 
l'algorithme, ce predicat recoit en parametre l'element courant de la recherche et l'une des valeurs de 
l'ensemble de valeurs specifie par les iterateurs premier2 et dernier2. La complexite de cet algo- 
rithme est nxm, ou n est le nombre d'elements de la sequence dans laquelle la recherche est effectuee 
et m est le nombre de valeurs avec lesquelles ces elements doivent etre compares. 

Exemple 18-16. Algorithme de recherche d'elements 

#include <iostream> 
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tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {0, 5, 3, 4, 255, 7, 0, 5, 255, 9 } ; 

// Recherche les elements valant ou 255 : 

int sep[2] = {0, 255}; 

int *debut = t; 

int *fin = t+10; 

int *courant; 

while ( (courant=find_first_of (debut , fin, 

sep, sep+2)) != fin) 
{ 

// Affiche la position de 1' element trouve : 

cout << *courant << " en position " << 
courant-t << endl; 

debut = courant+1; 
} 
return 0; 



18.2.2. Operations de recherche de motifs 

Les operations de recherche de motifs permettent de trouver les premieres et les dernieres occurrences 
d'un motif donne dans une suite de valeurs. Ces operations sont realisees respectivement par les 
algorithmes search et f ind_end, dont la declaration dans l'en-tete algorithm est la suivante : 

template <class Forwardlteratorl, class ForwardIterator2> 

Forwardlteratorl search (Forwardlteratorl premierl, Forwardlteratorl dernierl, 
ForwardIterator2 premier2, ForwardIterator2 dernier2); 

template <class Forwardlteratorl, class ForwardIterator2, 

class BinaryPredicate> 
Forwardlteratorl search (Forwardlteratorl premierl, Forwardlteratorl dernierl, 

ForwardIterator2 premier2, ForwardIterator2 dernier2, 

BinaryPredicate p) ; 

template <class Forwardlteratorl, class ForwardIterator2> 

Forwardlteratorl find_end (Forwardlteratorl premierl, Forwardlteratorl dernierl, 
ForwardIterator2 premier2, ForwardIterator2 dernier2); 

template <class Forwardlteratorl, class ForwardIterator2, 

class BinaryPredicate> 
Forwardlteratorl find_end (Forwardlteratorl premierl, Forwardlteratorl dernierl, 

ForwardIterator2 premier2, ForwardIterator2 dernier2, 

BinaryPredicate p) ; 



Tous ces algorithmes prennent en parametre deux couples d'iterateurs, le premier permettant 
d' identifier la sequence des valeurs dans laquelle la recherche du motif doit etre effectuee et le 
deuxieme permettant d' identifier le motif lui-meme. Chaque algorithme est fourni sous la forme de 
deux surcharges. La premiere recherche le motif en comparant les elements a l'aide de l'operateur 
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d'egalite du type des elements compares. La deuxieme permet d'effectuer cette comparaison a l'aide 
d'un predicat binaire, que Ton fournit dans ce cas en dernier parametre. 

La valeur retournee par l'algorithme search est un iterateur sur la premiere occurrence du motif dans 
la sequence de valeurs specifiees par les iterateurs premierl et dernierl ou l'iterateur dernierl 
lui-meme si ce motif n'y apparait pas. De meme, la valeur retournee par l'algorithme f ind_end est 
un iterateur referencant la derniere occurrence du motif dans la sequence des valeurs specifiee par 
les iterateurs premierl et dernierl, ou l'iterateur dernierl lui-meme si le motif n'a pas pu etre 
trouve. 

Exemple 18-17. Algorithmes de recherche de motif 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {1, 2, 4, 5, 3, 1, 2, 3, 5, 9}; 

// Recherche le motif {1, 2, 3} dans le tableau : 

int motif [3] = {1, 2, 3 } ; 

int *p = search(t, t+10, motif, motif+3); 

cout << "{1, 2, 3} en position " << 
p - t << endl; 

// Recherche la derniere occurrence de {1, 2} : 

p = find_end(t, t+10, motif, motif+2); 

cout << "Dernier {1, 2} en position " << 
p - t << endl; 

return 0; 
} 

La complexite de l'algorithme search est nxm, ou n est le nombre d'elements de la sequence spe- 
cifiee par le premier couple d' iterateurs et m est la longueur du motif a rechercher. La complexite de 
l'algorithme f ind_end est nx (n-m) . 

Lorsque tous les elements du motif sont egaux, il est possible d'utiliser l'algorithme search_n. Cet 
algorithme permet en effet de rechercher une serie de valeurs identiques dans une sequence. II est 
declare comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class Size, class T> 

Forwardlterator search_n (Forwardlterator premier, Forwardlterator dernier, 
Size nombre, const T Svaleur) ; 

template <class Forwardlterator, class Size, class T, 

class BinaryPredicate> 
Forwardlterator search_n (Forwardlterator premier, Forwardlterator dernier, 

Size nombre, const T Svaleur, BinaryPredicate p) ; 



Les deux surcharges de cet algorithme prennent en parametre les iterateurs definissant la sequence de 
valeurs dans laquelle la recherche doit etre effectuee, la longueur du motif a rechercher, et la valeur des 
elements de ce motif. La deuxieme version de cet algorithme accepte egalement un predicat binaire, 
qui sera utilise pour effectuer la comparaison des elements de la sequence dans laquelle la recherche 
se fait avec la valeur passee en parametre. La valeur retournee est un iterateur referencant la premiere 
occurrence du motif recherche ou l'iterateur dernier si ce motif n'existe pas dans la sequence de 
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valeurs analysee. La complexite de l'algorithme search_n est nxm, ou n est la taille de la sequence 
dans laquelle la recherche est effectuee et m est la longueur du motif recherche. 

Un cas particulier de la recherche de valeurs successives est 1' identification de doublons de va- 
leurs. Cette identification peut etre realisee grace a l'algorithme adjacent_f ind. Contrairement a 
l'algorithme search_n, adjacent_f ind localise tous les couples de valeurs d'une serie de valeurs, 
quelle que soit la valeur des elements de ces couples. II est done inutile de preciser cette valeur, et les 
surcharges de cet algorithme sont declarees comme suit dans l'en-tete algorithm : 

template <class ForwardIterator> 

Forwardlterator ad jacent_f ind (Forwardlterator premier, Forwardlterator dernier) 

template <class Forwardlterator, class BinaryPredicate> 

Forwardlterator ad jacent_f ind (Forwardlterator premier, Forwardlterator dernier, 
BinaryPredicate p) ; 



Les iterateurs fournis en parametre permettent comme a l'accoutumee de definir la sequence 
d'elements dans laquelle la recherche s'effectue. La deuxieme surcharge prend egalement en 
parametre un predicat binaire definissant la relation de comparaison utilisee par l'algorithme. La 
valeur retournee par ces algorithmes est l'iterateur referencant le premier doublon dans la sequence 
de valeurs analysee, ou l'iterateur dernier si aucun doublon n'existe. 

Exemple 18-18. Algorithme de recherche de doublons 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {0, 1, 2, 2, 3, 4, 4, 5, 6, 2}; 

// Recherche les doublons dans le tableau : 

int *debut = t; 

int *fin = t+10; 

int *p; 

while ( (p = ad jacent_f ind (debut , fin)) != fin) 

{ 

cout << "Doublon en position " << p-t << endl; 

debut = p+1; 



return 0; 



} 



La complexite de cet algorithme est lineaire en fonction de la taille de la sequence de valeurs dans 
laquelle la recherche se fait. 



18.3. Operations d'ordonnancement 



La bibliotheque standard fournit plusieurs algorithmes relatifs a l'ordonnancement des elements dans 
les conteneurs. Grace a ces algorithmes, il est possible de reorganiser la sequence de ces elements 
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de maniere a obtenir certaines proprietes basees sur la relation d'ordre. Ces reorganisations ont gene- 
ralement pour but soit de trier completement ces sequences, soit d'effectuer des tris partiels a partir 
desquels il est possible d' obtenir des informations relatives a l'ordre des elements de maniere tres 
efficace. 

La plupart des algorithmes de tri et d'ordonnancement se basent sur une structure de donnees tres 
performante : les « tas ». Les algorithmes de manipulation de ces structures de donnees seront done 
decrits en premier. Les sections qui suivront traiteront ensuite des algorithmes de tri et de recherches 
binaires dans un ensemble d'elements deja trie. 

18.3.1. Operations de gestion des tas 

Un tas (« heap » en anglais) est une structure de donnees recursive dans laquelle le premier element 
est toujours le plus grand element et qui dispose d'une operation de suppression du premier element 
ainsi que d'une operation d'ajout d'un nouvel element extremement performantes. Plus precisement, 
les proprietes fondamentales des tas sont les suivantes : 

• le premier element du tas est toujours le plus grand de tous les elements contenus ; 

• il est possible de supprimer ce premier element et cette operation de suppression a une complexite 
logarithmique en fonction du nombre d'elements dans le tas ; 

• il est possible d'ajouter un nouvel element dans le tas avec une complexite egalement logarithmique 
en fonction du nombre d'elements deja presents. 

Les tas sont done particulierement adaptes pour realiser les files de priorite puisque la determination 
du plus grand element est immediate et que la suppression de cet element se fait avec une complexite 
logarithmique. Les tas sont egalement tres utiles dans 1' implementation des algorithmes de tri car ils 
permettent d'atteindre une complexite algorithmique en nxin (n) , ce qui est l'optimum. 

Note : En pratique, un tas est une forme d'arbre binaire equilibre dont la propriete recursive 
est que la racine de I'arbre est I'element de plus grande valeur et que les deux branches de 
I'arbre sont eux-meme des tas. La suppression de la racine, ainsi que I'ajout d'un nouvel element, 
necessite une reorganisation de I'arbre binaire, ce qui ne peut depasser in(n) operations en 
raison de son aspect equilibre. 

Notez que les tas ne garantissent pas, contrairement aux B-arbres et aux arbres rouges et noirs, 
que tous les elements situes a la gauche d'un noeud sont plus grands que le noeud lui-meme et 
que tous les elements situes a la droite sont plus petits. C'est pour cette raison qu'un tas n'est 
justement pas completement trie, et que les algorithmes de gestion des tas ne font que conserver 
cet ordre partiel. 

La representation des tas en memoire peut etre relativement difficile a comprendre. En general, 
il est d'usage de les stacker dans des tableaux, car les operations de gestion des tas requierent 
des iterateurs a acces aleatoires sur le conteneur sur lequel elles travaillent. Dans ce cas, les 
premiers elements du tableau stockent les noeuds de I'arbre binaire du tas, et les feuilles sont 
placees dans la seconde moitie du tableau. Ainsi, un element d'indice i a comme feuilles les 
elements d'indice 2xi et 2xi+i (pour tout i < n/2). Reportez-vous a la bibliographie pour plus 
de renseignements sur les structures de donnees et les notions algorithmiques associees. 



Les algorithmes de manipulation des tas sont declares comme suit dans 1'en-tete algorithm : 

template <class RandomAccessIterator> 

void make_heap (RandomAccessIterator premier, RandomAccessIterator dernier) 

template <class RandomAccessIterator, class Compare> 
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void make_heap (RandomAccessIterator premier, RandomAccessIterator dernier, 
Compare c) ; 

template <class RandomAccessIterator> 

void pop_heap (RandomAccessIterator premier, RandomAccessIterator dernier); 

template <class RandomAccessIterator, class Compare> 

void pop_heap (RandomAccessIterator premier, RandomAccessIterator dernier, 
Compare c) ; 

template <class RandomAccessIterator> 

void push_heap (RandomAccessIterator premier, RandomAccessIterator dernier); 

template <class RandomAccessIterator, class Compare> 

void push_heap (RandomAccessIterator premier, RandomAccessIterator dernier, 
Compare c) ; 

template <class RandomAccessIterator> 

void sort_heap (RandomAccessIterator premier, RandomAccessIterator dernier); 

template <class RandomAccessIterator, class Compare> 

void sort_heap (RandomAccessIterator premier, RandomAccessIterator dernier, 
Compare c) ; 



L'algorithme make_heap permet de construire un nouveau tas a partir d'une sequence d' elements 
quelconque. II prend simplement en parametre les iterateurs de debut et de fin de cette sequence, et ne 
retourne rien. Sa complexite est une fonction lineaire du nombre d'elements references par ces deux 
iterateurs. 

Les algorithmes pop_heap et push_heap permettent respectivement de supprimer la tete d'un tas 
existant et d'ajouter un nouvel element dans un tas. pop_heap prend en parametre deux iterateurs 
referencant le premier et le dernier element du tas. II place le premier element du tas en derniere 
position et reorganise les elements restants de telle sorte que les dernier-premier-l elements 
constituent un nouveau tas. L'algorithme push_heap en revanche effectue le travaille inverse : il 
prend en parametre deux iterateurs referencant une sequence dont les premiers elements sauf le dernier 
constituent un tas et y ajoute l'element reference par l'iterateur dernier-l. Ces deux operations 
effectuent leur travail avec une complexite logarithmique. 

Enfin, l'algorithme sort_heap permet simplement de trier une sequence ayant la structure de tas. Sa 
complexite est nxln (n) , ou n est le nombre d'elements de la sequence. 

Exemple 18-19. Algorithmes de manipulation des tas 

tinclude <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {5, 8, 1, 6, 7, 9, 4, 3, 0, 2}; 

// Construit un tas a partir de ce tableau : 

make_heap (t, t+10); 

// Affiche le tas : 

int i; 
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for (i=0; i<10; ++i) 

cout << t[i] << " "; 
cout << endl; 

// Supprime 1' element de tete : 
pop_heap(t, t+10); 

// L' element de tete est en position 9 
cout << "Max = " << t[9] << endl; 
// Affiche le nouveau tas : 
for (i=0; i<9; ++i) 

cout << t[i] << " "; 
cout << endl; 
// Ajoute un element : 
t [ 9 ] = 6 ; 

push_heap(t, t+10); 
// Affiche le nouveau tas : 
for (i=0; i<10; ++i) 

cout << t[i] << " "; 
cout << endl; 
// Tri le tas : 
sort_heap (t, t+10); 
// Affiche le tableau ainsi trie : 
for (i=0; i<10; ++i) 

cout << t[i] << " "; 
cout << endl; 
return 0; 



18.3.2. Operations de tri 

Les operations de tri de la bibliotheque standard s'appuient sur les algorithmes de manipulation des tas 
que Ton vient de voir. Ces methodes permettent d'effectuer un tri total des elements d'une sequence, 
un tri stable, legerement moins performant que le precedent mais permettant de conserver l'ordre 
relatif des elements equivalents, et un tri partiel. 

Les algorithmes de tri sont declares comme suit dans l'en-tete algorithm : 

template <class RandomAccessIterator> 

void sort (RandomAccessIterator premier, RandomAccessIterator dernier) ; 

template <class RandomAccessIterator, class Compare> 

void sort (RandomAccessIterator premier, RandomAccessIterator dernier, 
Compare c) ; 

template <class RandomAccessIterator> 

void stable_sort (RandomAccessIterator premier, RandomAccessIterator dernier) 

template <class RandomAccessIterator, class Compare> 

void stable_sort (RandomAccessIterator premier, RandomAccessIterator dernier, 
Compare c) ; 



Les algorithmes sort et stable_sort s'utilisent de la meme maniere et permettent de trier com- 
pletement la sequence qui leur est specifiee a l'aide des deux iterateurs premier et dernier. Ces 
deux algorithmes effectuent un tri par ordre croissant en utilisant l'operateur d'inferiorite du type des 
elements de la sequence a trier. Cependant, il est egalement possible d'utiliser un autre critere, en 
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specifiant un foncteur binaire en troisieme parametre. Ce foncteur doit etre capable de comparer deux 
elements de la sequence a trier et d'indiquer si le premier est ou non le plus petit au sens de la relation 
d'ordre qu'il utilise. 

Exemple 18-20. Algorithme de tri 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {2, 3, 7, 5, 4, 1, 8, 0, 9, 6}; 

// Trie le tableau : 

sort(t, t+10); 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

cout << t[i] << " "; 

cout << endl; 

return 0; 
} 

II se peut que plusieurs elements de la sequence soient considered comme equivalents par la relation 
d'ordre utilisee. Par exemple, il est possible de trier des structures selon l'un de leurs champs, et plu- 
sieurs elements peuvent avoir la meme valeur dans ce champ sans pour autant etre strictement egaux. 
Dans ce cas, il peut etre necessaire de conserver l'ordre relatif initial de ces elements dans la sequence 
a trier. L' algorithme sort ne permet pas de le faire, cependant, l'algorithme stable_sort garantit 
la conservation de cet ordre relatif, au prix d'une complexite algorithmique legerement superieure. En 
effet, la complexite de stable_sort est nxin 2 (n) (ou n est le nombre d' elements a trier), alors que 
celle de l'algorithme sort n'est que denxin(n). Hormis cette petite difference, les deux algorithmes 
sont strictement equivalents. 

Dans certaines situations, il n'est pas necessaire d'effectuer un tri total des elements. En effet, le tri des 
premiers elements d'une sequence seulement ou bien seule la determination du nieme element d'un 
ensemble peuvent etre desires. A cet effet, la bibliotheque standard fournit les algorithmes suivants : 

template <class RandomAccessIterator> 

void partial_sort (RandomAcoessIterator premier, 

RandomAccessIterator pivot, RandomAcoessIterator dernier); 

template <class Inputlterator, class RandomAocessIterator> 
RandomAccessIterator partial_sort_copy ( 

Inputlterator premier, Inputlterator dernier, 

RandomAccessIterator debut_resultat, RandomAccessIterator f in_resultat ) ; 

template <class RandomAccessIterator, class Compare> 
void partial_sort ( 

RandomAccessIterator premier, RandomAccessIterator fin_tri, 

RandomAccessIterator dernier, Compare c); 

template <class Inputlterator, class RandomAccessIterator, 

class Compare> 
RandomAccessIterator partial_sort_copy ( 

Inputlterator premier, Inputlterator dernier, 
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RandomAccessIterator debut_resultat, RandomAccessIterator f in_resultat , 
Compare c) ; 

template <class RandomAccessIterator> 

void nth_element (RandomAccessIterator premier, RandomAccessIterator position, 
RandomAccessIterator dernier) ; 

template <class RandomAccessIterator, class Compare> 

void nth_element (RandomAccessIterator premier, RandomAccessIterator position, 
RandomAccessIterator dernier, Compare c) ; 



L'algorithme partial_sort permet de n'effectuer qu'un tri partiel d'une sequence. Cet algorithme 
peut etre utilise lorsqu'on desire n'obtenir que les premiers elements de la sequence triee. Cet al- 
gorithme existe en deux versions. La premiere version prend en parametre l'iterateur de debut de 
la sequence, l'iterateur de la position du dernier element de la sequence qui sera triee a la fin de 
l'execution de l'algorithme, et l'iterateur de fin de la sequence. La deuxieme version, nominee par- 
tial_sort_copy, permet de copier le resultat du tri partiel a un autre emplacement que celui de la 
sequence initiale. Cette version de 1' algorithme de tri partiel prend alors deux couples d'iterateurs en 
parametre, le premier specifiant la sequence sur laquelle l'algorithme doit travailler et le deuxieme 
F emplacement destination dans lequel le resultat doit etre stocke. Enfin, comme pour tous les autres 
algorithmes, il est possible de specifier un autre operateur de comparaison que l'operateur d'inferiorite 
utilise par defaut en fournissant un foncteur binaire en dernier parametre. 

Exemple 18-21. Algorithme de tri partiel 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {2, 3, 7, 5, 4, 1, 8, 0, 9, 6}; 

// Trie les 5 premiers elements du tableau : 

partial_sort (t, t+5, t+10); 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

cout << t[i] << " "; 

cout << endl; 

return 0; 



La complexite de l'algorithme partial_sort est nxin (m) , ou n est la taille de la sequence sur 
laquelle l'algorithme travaille et m est le nombre d'elements tries a obtenir. 

L'algorithme nth_element permet quant a lui de calculer la valeur d'un element de rang donne 
dans le conteneur si celui-ci etait completement trie. Cet algorithme prend en parametre l'iterateur 
de debut de la sequence a traiter, l'iterateur referencant l'emplacement qui recevra l'element qui sera 
place a sa position a la fin de l'operation de tri partiel et l'iterateur de fin de la sequence. II est 
egalement possible, comme pour les autres algorithmes, de specifier un foncteur a utiliser pour tester 
l'inferiorite des elements de la sequence. A Tissue de l'appel, le n-ieme element de la sequence sera 
le meme element que celui qui se trouverait a cette position si la sequence etait completement triee 
selon la relation d'ordre induite par l'operateur d'inferiorite ou par le foncteur fourni en parametre. 
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La complexite de l'algorithme nth_element est lineaire en fonction du nombre d'elements de la 
sequence a traiter. 

Exemple 18-22. Algorithme de positionnement du nieme element 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {2, 3, 9, 6, 7, 5, 4, 0, 1, 8}; 

// Trie tous les elements un a un : 

int i; 

for (i=0; i<10; ++i) 

{ 

nth_element (t, t+i, t+10); 
cout << "L' element " << i << 

" a pour valeur " << t[i] << endl; 
} 
return 0; 



Enfin, et bien que ces algorithmes ne fassent pas a proprement parler des operations de tri, la 
bibliotheque standard fournit deux algorithmes permettant d'obtenir le plus petit et le plus grand 
des elements d'une sequence. Ces algorithmes sont declares de la maniere suivante dans l'en-tete 

algorithm : 

template <class ForwardIterator> 

Forwardlterator min_element (Forwardlterator premier, Forwardlterator dernier) ; 

template <class Forwardlterator, class Compare> 

Forwardlterator min_element (Forwardlterator premier, Forwardlterator dernier, 
Compare c) ; 

template <class ForwardIterator> 

Forwardlterator max_element (Forwardlterator premier, Forwardlterator dernier) ; 

template <class Forwardlterator, class Compare> 

Forwardlterator max_element (Forwardlterator premier, Forwardlterator dernier, 
Compare c) ; 



Ces deux algorithmes prennent en parametre deux iterateurs permettant de definir la sequence des 
elements dont le minimum et le maximum doivent etre determines. lis retournent un iterateur refe- 
rencant respectivement le plus petit et le plus grand des elements de cette sequence. La complexite de 
ces algorithmes est proportionnelle a la taille de la sequence fournie en parametre. 

Exemple 18-23. Algorithmes de determination du maximum et du minimum 

#include <iostream> 
#include <algorithm> 

using namespace std; 
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int main (void) 
{ 

int t[10] = {5, 2, 4, 6, 3, 7, 9, 1, 0, 8}; 

// Affiche le minimum et le maximum : 

cout << *min_element (t, t+10) << endl; 

cout << *max_element (t, t+10) << endl; 

return 0; 
} 



18.3.3. Operations de recherche binaire 

Les operations de recherche binaire de la bibliotheque standard sont des operations qui permettent de 
manipuler des sequences d' elements deja triees en se basant sur cet ordre. Les principales fonctionna- 
lites de ces algorithmes sont de rechercher les positions des elements dans ces sequences en fonction 
de leur valeur. 

Les principaux algorithmes de recherche binaire sont les algorithmes lower_bound et 
upper_bound. Ces algorithmes sont declares comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class T> 

Forwardlterator lower_bound (Forwardlterator premier, Forwardlterator dernier, 

const T Svaleur) ; 

template <class Forwardlterator, class T, class Compare> 

Forwardlterator lower_bound (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur, Compare c) ; 

template <class Forwardlterator, class T> 

Forwardlterator upper_bound (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur) ; 

template <class Forwardlterator, class T, class Compare> 

Forwardlterator upper_bound (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur, Compare c) ; 



L'algorithme lower_bound determine la premiere position a laquelle la valeur valeur peut etre 
inseree dans la sequence ordonnee specifiee par les iterateurs premier et dernier sans en briser 
l'ordre. De meme, l'algorithme upper_bound determine la derniere position a laquelle la valeur 
valeur peut etre inseree sans casser l'ordre de la sequence sur laquelle il travaille. II est suppose ici 
que l'insertion se ferait avant les elements indiques par ces iterateurs, comme c'est generalement le 
cas pour tous les conteneurs. 

Si le programmeur veut determiner simultanement les deux iterateurs renvoyes par les algorithmes 

lower_bound et upper_bound, il peut utiliser l'algorithme equal_range suivant : 

template <class Forwardlterator, class T> 
pair<ForwardIterator , ForwardIterator> 

equal_range (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur) ; 

template <class Forwardlterator, class T, class Compare> 
pair<ForwardIterator , ForwardIterator> 

equal_range (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur, Compare comp) ; 
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Cet algorithme renvoie une paire d' iterateurs contenant respectivement la premiere et la derniere des 
positions auxquelles la valeur valeur peut etre inseree sans perturber l'ordre de la sequence identifiee 
par les iterateurs premier et dernier. 

Exemple 18-24. Algorithmes de determination des bornes inferieures et superieures 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {1, 2, 4, 4, 4, 5, 8, 9, 15, 20}; 

// Determine les positions possibles d' insertion 

// d'un 4 : 

cout << "4 peut etre insere de " << 

lower_bound(t, t+10, 4) - t << 

" a " << 

upper_bound (t , t+10, 4) - t << endl; 
// Recupere ces positions directement 
// avec equal_range : 

pair<int *, int *> p = equal_range (t , t+10, 4 ) ; 
cout << "Equal range donne l'intervalle [" << 

p.first-t << ", " << p.second-t << "]"; 
cout << endl; 
return ; 
} 

Comme pour la plupart des algorithmes de la bibliotheque standard, il est possible de specifier 
un foncteur qui devra etre utilise par les algorithmes de recherche binaire dans les comparaisons 
d'inferiorite des elements de la sequence. 

Enfin, l'algorithme binary_search permet de determiner si un element d'un conteneur au moins 
est equivalent a une valeur donnee au sens de l'operateur d'inferiorite ou au sens d'un foncteur fourni 
en parametre. Cet algorithme est declare de la maniere suivante dans l'en-tete algorithm : 

template <class Forwardlterator, class T> 

bool binary_search (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur) ; 

template <class Forwardlterator, class T, class Compare> 
bool binary_search (Forwardlterator premier, Forwardlterator dernier, 
const T Svaleur, Compare c) ; 



Cet algorithme prend en parametre les deux iterateurs definissant la sequence d' elements a tester, 
la valeur avec laquelle ses elements doivent etre testes, et eventuellement un foncteur permettant 
de realiser une operation de comparaison autre que celle de l'operateur d'inferiorite. II renvoie un 
booleen indiquant si un des elements au moins du conteneur est equivalent a la valeur fournie en 
parametre. 

Note : La relation d'equivalence utilisee par cet algorithme n'est pas celle induite par l'operateur 
d'egalite des elements. En realite, deux elements x et y sont consideres comme equivalents si 
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et seulement si les deux inequations x<y et y<x sont fausses. C'est la raison pour laquelle le 
foncteur fourni en parametre ne doit pas definir la relation d'egalite, mais la relation d'inferiorite. 

Cette distinction a son importance si certains elements de la sequence ne sont pas comparables 
ou si I'operateur d'egalite definit une autre relation que I'operateur d'inferiorite. Bien entendu, en 
pratique, ces deux inequations signifie souvent que les valeurs x et y sont egales. 



Exemple 18-25. Algorithme de recherche binaire 

#include <iostream> 
#include <string> 
#include <algorithm> 

using namespace std; 

struct A 

{ 

int numero; // Numero unique de 1' element 
string nom; // Nom de 1' element 

A(const char *s) : 

nom (s) 
{ 

// Affecte un nouveau numero : 

static int i=0; 

numero = ++i; 
} 

// Operateur de classement : 
bool operator< (const A &a) const 
{ 

return (numero < a. numero); 
} 

// Operateur d'egalite (jamais utilise) : 

bool operator== (const A &a) const 

{ 

return (nom == a. nom); 



int main (void) 
{ 

// Construit un tableau d' elements tries 

// (par construction, puisque le numero est increments 

// a chaque nouvel objet) : 

A t[5] = {"Jean", "Marc", "Alain", "Ariane", "Sophie"}; 

// Cette instance a le meme nom que t[l] 

// mais ne sera pas trouve car son numero est different 

A test ("Marc") ; 

// Effectue la recherche de test dans le tableau : 

if (binary_search (t , t+5, test)) 

{ 

cout << "(" << test, numero << ", " << 

test. nom << ") a ete trouve" << endl; 

} 
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else 
{ 

cout << "(" << test.numero << ", " << 

test.nom << ") n'a pas ete trouve" << endl; 
} 

return 0; 
} 

La complexity algorithmique de tous ces algorithmes est logarithmique en fonction du nombre 
d' elements de la sequence sur laquelle ils travaillent. lis s'appuient sur le fait que cette sequence est 
deja triee pour atteindre cet objectif. 



18.4. Operations de comparaison 



Afin de faciliter la comparaison de conteneurs de natures differentes pour lesquels, de surcroit, il 
n'existe pas forcement d'operateurs de comparaison, la bibliotheque standard fournit plusieurs al- 
gorithmes de comparaison. Ces algorithmes sont capables d'effectuer une comparaison element a 
element des differents conteneurs pour verifier leur egalite en terme d' elements contenus, ou de deter- 
miner une relation d'ordre au sens lexicographique. Enfin, il est possible de determiner les elements 
par lesquels deux conteneurs se differencient. 

L'algorithme general de comparaison des conteneurs est l'algorithme equal. Cet algorithme est de- 
clare comme suit dans l'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2> 
bool equal ( Input Iteratorl premierl, Inputlteratorl dernierl, 
InputIterator2 premier2); 

template <class Inputlteratorl, class InputIterator2, class BinaryPredicate> 
bool equal ( Input Iteratorl premierl, Inputlteratorl dernierl, 
Input Iterator2 premier2, BinaryPredicate p) ; 



Comme vous pouvez le constater d'apres cette declaration, l'algorithme equal prend en parametre 
un couple d' iterateurs decrivant la sequence d' elements qui doivent etre pris en compte dans la com- 
paraison ainsi qu'un iterateur sur le premier element du deuxieme conteneur. Les elements references 
successivement par les iterateurs premierl et premier2 sont ainsi compares, jusqu'a ce qu'une 
difference soit detectee ou que l'iterateur dernierl du premier conteneur soit atteint. La valeur re- 
tournee est true si les deux sequences d' elements des deux conteneurs sont egales element a element, 
et false sinon. Bien entendu, il est possible de specifier un foncteur binaire que l'algorithme devra 
utiliser pour realiser les comparaisons entre les elements des deux conteneurs. S'il est specifie, ce 
foncteur est utilise pour determiner si les elements compares sont egaux ou non. 

Note : Notez bien ici que le foncteur fourni permet de tester I'egalite de deux elements et non 
I'inferiorite, comme c'est le cas avec la plupart des autres algorithmes. 



S'il s'avere que les deux conteneurs ne sont pas egaux membre a membre, il peut etre utile de deter- 
miner les iterateurs des deux elements qui ont fait echouer le test d' egalite. Cela peut etre realise a 
l'aide de l'algorithme mismatch dont on trouvera la declaration dans l'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2> 
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pair< Input Iterator!., Input Iter at or 2 > 

mismatch ( Input Iteratorl premierl, Inputlteratorl dernierl, 
InputIterator2 premier2); 

template <class Inputlteratorl, class InputIterator2, class BinaryPredicate> 
pair< Input Iteratorl, Input Iter at or 2 > 

mismatch ( Input Iteratorl premierl, Inputlteratorl dernierl, 
Input Iterator2 premier2, BinaryPredicate p) ; 



Cet algorithme fonctionne exactement de la meme maniere que l'algorithme equal. Cependant, 
contrairement a ce dernier, sa valeur de retour est une paire d'iterateurs des deux conteneurs refe- 
rencant les elements respectifs qui ne sont pas egaux au sens de l'operation de comparaison utilisee 
par l'algorithme (que ce soit l'operateur d'egalite ou le foncteur fourni en parametre). Si les deux 
conteneurs sont effectivement egaux, la valeur retournee est la paire contenant l'iterateur dernierl 
et l'iterateur correspondant dans le deuxieme conteneur. 

Exemple 18-26. Algorithme de comparaison de conteneurs 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int tl[10] = {5, 6, 4, 7, 8, 9, 2, 1, 3, 0}; 
int t2[10] = {5, 6, 4, 7, 9, 2, 1, 8, 3, 0}; 
// Compare les deux tableaux : 
if (! equal (tl, tl+10, t2)) 
{ 

// Determine les elements differents : 
pair<int *, int *> p = 

mismatch (tl, tl+10, t2); 
cout << *p. first << " est different de " << 
*p. second << endl; 
} 
return ; 



Enfin, la bibliotheque standard fournit un algorithme de comparaison general permettant de determi- 
ner si un conteneur est inferieur a un autre conteneur selon la relation d'ordre lexicographique induite 
par l'operateur d'inferiorite du type de leurs elements. Rappelons que l'ordre lexicographique est ce- 
lui utilise par le dictionnaire : les elements sont examines un a un et dans leur ordre d' apparition et 
la comparaison s'arrete des que deux elements differents sont trouves. En cas d'egalite totale, le plus 
petit des conteneurs est celui qui contient le moins d'elements. 

L'algorithme de comparaison lexicographique est l'algorithme lexicographical_compare. II est 
declare comme suit dans l'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2> 

bool lexicographical_compare ( Inputlteratorl premierl, Inputlteratorl dernierl, 
InputIterator2 premier2, Input Iterator2 dernier2); 

template <class Inputlteratorl, class InputIterator2, class Compare> 

bool lexicographical_compare ( Inputlteratorl premierl, Inputlteratorl dernierl, 
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InputIterator2 premier2, InputIterator2 dernier2, 
Compare c) ; 



Cet algorithme prend en parametre deux couples d'iterateurs grace auxquels le programmeur 
peut specifier les deux sequences d'elements a comparer selon l'ordre lexicographique. Comme 
a l'accoutumee, il est egalement possible de fournir un foncteur a utiliser pour les tests 
d'inferiorite entre les elements des deux conteneurs. La valeur retournee par l'algorithme 

lexicographical_compare est true si le premier conteneur est strictement plus petit que le 
deuxieme et false sinon. 

Exemple 18-27. Algorithme de comparaison lexicographique 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int tl[10] = {5, 6, 4, 7, 8, 9, 2, 1, 3, 0}; 

int t2[10] = {5, 6, 4, 7, 9, 2, 1, 8, 3, 0}; 

// Compare les deux tableaux : 

if (lexicographical_compare (tl, tl+10, t2, t2+10)) 

{ 

cout << "tl est plus petit que t2" << endl; 

} 

return 0; 
} 

Tous ces algorithmes de comparaison s'executent avec une complexite lineaire en fonction du nombre 
d'elements a comparer. 



18.5. Operations ensemblistes 



En mathematiques, il est possible d'effectuer differents types d'operations sur les ensembles. Ces ope- 
rations comprennent la determination de l'inclusion d'un ensemble dans un autre, leur union (c'est- 
a-dire le regroupement de tous leurs elements), leur intersection (la selection de leurs elements com- 
muns), leur difference (la suppression des elements d'un ensemble qui appartiennent aussi a un autre 
ensemble) et leur parti tionnement (le decoupage d'un ensemble en sous-ensemble dont les elements 
verifient une propriete discriminante). 

La bibliotheque standard fournit tout un ensemble d' algorithmes qui permettent d'effectuer les ope- 
rations ensemblistes classiques sur les conteneurs tries. Tous ces algorithmes sont decrits ci-dessous 
et sont classes selon la nature des operations qu'ils realisent. 

Note : Remarquez ici que la notion de tri est importante : les algorithmes s'appuient sur cette 
propriete des conteneurs pour effectuer leur travail. En contrepartie de cette contrainte, les per- 
formances de ces algorithmes sont excellentes. 
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18.5.1. Operations d'inclusion 

L'inclusion d'un ensemble dans un autre peut etre realisee a l'aide de l'algorithme includes. Cet 
algorithme est declare comme suit dans l'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2> 
bool includes ( Inputlteratorl premierl, Inputlteratorl dernierl, 
InputIterator2 premier2, Input Iterator2 dernier2); 

template <class Inputlteratorl, class InputIterator2, class Compare> 
bool includes ( Inputlteratorl premierl, Inputlteratorl dernierl, 

Input Iterator2 premier2, Input Iterator2 dernier2, Compare c); 



L'algorithme includes prend en parametre deux couples d'iterateurs permettant de definir les se- 
quences d'elements des deux ensembles sur lesquels il doit travailler. La valeur retournee par cet 
algorithme est true si tous les elements de la sequence identifiee par les iterateurs premier2 et 
dernier2 sont egalement presents dans la sequence identifiee par les iterateurs premierl et der- 
nierl. L'algorithme considere qu'un element est present dans un ensemble s'il existe au moins un 
element de cet ensemble qui lui est identique. Chaque element utilise de l'ensemble ne l'est qu'une 
seule fois, ainsi, si l'ensemble dont on teste l'inclusion dispose de plusieurs copies du meme element, 
il faut qu'il y en ait autant dans l'ensemble conteneur pour que le test d'inclusion soit valide. 

Bien entendu, il est possible d'utiliser une autre relation que l'egalite pour determiner l'appartenance 
d' un element a un ensemble, pour cela, il suffit de fournir un foncteur binaire en dernier parametre. Ce 
predicat doit prendre deux elements en parametre et renvoyer true si le premier element est inferieur 
au second, et false dans le cas contraire. 

Note : II est important que le foncteur d'inferiorite specifies soit compatible avec la relation d'ordre 
utilisee pour le tri des elements des conteneurs. Si ce n'est pas le cas, l'algorithme peut ne pas 
fonctionner correctement. 



Exemple 18-28. Algorithme de determination d'inclusion 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int tl[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; 

int t2 [3] = {4, 5, 6}; 

if (includes (tl, tl + 10, t2, t2 + 3)) 

cout << "tl contient t2" << endl; 

return 0; 
} 

La complexite de l'algorithme includes est n+m, oil n et m sont respectivement les tailles des deux 
conteneurs qui lui sont fournis en parametre. 
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18.5.2. Operations d'intersection 

L' intersection de deux ensembles peut etre realisee a l'aide de l'algorithme set_intersection. Cet 
algorithme est declare de la maniere suivante dans l'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator> 
Output Iterator set_intersection (Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination) ; 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator, class Compare> 
Outputlterator set_intersection (Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination, Compare c) ; 



Cet algorithme prend en parametre les iterateurs de debut et de fin des deux conteneurs dont 
l'intersection doit etre determinee, ainsi qu'un iterateur referencant l'emplacement destination ou les 
elements de l'intersection doivent etre stockes. Pour ceux qui le desirent, il est egalement possible de 
specifier un foncteur que l'algorithme utilisera pour effectuer les comparaisons d'inferiorite entre les 
elements des deux conteneurs fournis en parametre. Ce foncteur devra bien entendu etre compatible 
avec la relation d'ordre selon laquelle les conteneurs passes en parametre sont tries. 

L'algorithme copie a l'emplacement destination tous les elements du premier conteneur qui font ega- 
lement partie du deuxieme. Le critere d'appartenance a un ensemble est, comme pour l'algorithme 
includes, le fait qu'il existe au moins un element dans le deuxieme ensemble egal a l'element consi- 
dere. De meme, si plusieurs copies d'un meme element se trouvent dans chaque ensemble, le nombre 
de copies de l'intersection sera le plus petit nombre de copies de l'element dans les deux ensembles 
sources. 

Exemple 18-29. Algorithme d'intersection d'ensembles 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int tl[10] = {2, 4, 6, 8, 9, 10, 15, 15, 15, 17}; 

int t2[10] = {1, 4, 5, 8, 11, 15, 15, 16, 18, 19}; 

int t [10] ; 

// Effectue l'intersection de tl et de t2 : 

int *fin = set_intersection (t 1, tl + 10, t2, t2 + 10, t); 

// Affiche le resultat : 

int *p = t; 

while (p != fin) 

{ 

cout << *p << " "; 

++p; 
} 

cout << endl; 
return 0; 
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La complexite de l'algorithme est n+m, ou n et m sont respectivement les tailles des deux conteneurs 
qui lui sont fournis en parametre. 



18.5.3. Operations d'union et de fusion 

La bibliotheque standard fournit plusieurs algorithmes permettant de realiser l'union de deux en- 
sembles. Ces variantes se distinguent par la maniere qu'elles ont de traiter le cas des elements en 
multiples exemplaires. 

L'algorithme set_union considere que les elements equivalents des deux ensembles sont les memes 
entites et ne les place qu'une seule fois dans l'ensemble resultat de l'union. Toutefois, si ces elements 
sont en plusieurs exemplaires dans un des ensembles source, ils apparaitront egalement en plusieurs 
exemplaires dans le resultat. Autrement dit, le nombre d'elements presents dans l'ensemble destina- 
tion est le nombre maximum du compte de ses occurrences dans chacun des deux ensembles source. 

Inversement, l'algorithme merge effectue une union au sens large et ajoute les elements de chaque en- 
semble dans l'ensemble resultat sans considerer leurs valeurs. Ainsi, le nombre d'elements du resultat 
est strictement egal a la somme des nombres des elements de chaque conteneur source. 

Afin de distinguer ces deux comportements, on peut dire que l'algorithme set_union realise V union 
des deux ensembles, alors que l'algorithme merge realise leur fusion. 

Tous ces algorithmes sont declares comme suit dans 1'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator> 
Output Iterator set_union (Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination) ; 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator, class Compare> 
Outputlterator set_union (Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination, Compare c) ; 

template <class Inputlteratorl, class InputIterator2, class Outputlterator> 
Outputlterator merge (Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination) ; 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator, class Compare> 
Outputlterator merge (Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 dernier2, Input Iterator2 premier2, 

Outputlterator destination, Compare c) ; 



Comme vous pouvez le constater, ils prennent tous en parametre les iterateurs permettant de specifier 
les deux ensembles ainsi qu'un iterateur destination indiquant l'emplacement ou les elements de 
l'union ou de la fusion doivent etre stockes. Enfin, si le programmeur le desire, il peut egalement 
donner le foncteur definissant la relation d'ordre selon laquelle les ensembles sont tries. 
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Exemple 18-30. Algorithmes d'union et de fusion d'ensembles 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int tl [4] = {1, 2, 5, 5}; 

int t2 [6] = {3, 4, 5, 5, 5, 7}; 

int t [10] ; 

// Effectue l'union de tl et de t2 : 

int *fin = set_union (tl, tl+4, t2, t2+6, t); 

// Affiche le resultat : 

int *p = t; 

while (p != fin) 

{ 

cout << *p << " "; 

t+p; 
} 

cout << endl; 

// Effectue la fusion de tl et de t2 : 
fin = merge (tl, tl+4, t2, t2+6, t ) ; 
// Affiche le resultat : 
P = t; 

while (p != fin) 
{ 

cout << *p << " "; 

++p; 
} 

cout << endl; 
return 0; 



La bibliotheque standard fournit egalement une version modifiee de l'algorithme merge dont le but est 
de fusionner deux parties d'une meme sequence d' elements triees independamment l'une de 1' autre. 
Cet algorithme permet d'effectuer la fusion sur place, et ne travaille done que sur un seul conteneur. 
II s'agit de l'algorithme inplace_merge, qui est declare comme suit : 

template <class BidirectionalIterator> 

void inplace_merge (Bidirectionallterator premier, 

Bidirectionallterator separation, 

Bidirectionallterator dernier) ; 

template <class Bidirectionallterator, class Compare> 
void inplace_merge (Bidirectionallterator premier, 

Bidirectionallterator separation, 

Bidirectionallterator dernier, Compare c) ; 



Cet algorithme effectue la fusion des deux ensembles identifies respectivement par les iterateurs pre- 
mier et separation d'une part, et par les iterateurs separation et dernier d'autrepart. Enfin, si 
besoin est, il est possible de specifier le foncteur selon lequel ces deux ensembles sont tries. 
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Exemple 18-31. Algorithme de reunification de deux sous-ensembles 

#include <iostream> 
#include <algorithm> 

using namespace std; 

int main (void) 
{ 

int t[10] = {1, 5, 9, 0, 2, 3, 4, 6, 7, 8}; 

// Fusionne les deux sous-ensembles de t 

// (la separation est au troisieme element) : 

inplace_merge (t , t + 3, t + 10); 

// Affiche le resultat : 

int i; 

for (i=0; i<10; ++i) 

{ 

cout << t[i] << " "; 

} 

cout << endl; 

return ; 



Tous les algorithmes d' union et de fusion ont une complexite n+m, ou n et m sont les tailles des deux 
ensembles a fusionner ou a reunir. 



18.5.4. Operations de difference 

La difference entre deux ensembles peut etre realisee avec l'algorithme set_dif ference. Cet al- 
gorithme supprime du premier ensemble tous les elements du second, si necessaire. Chaque element 
n'est supprime qu'une seule fois, ainsi, si le premier ensemble contient plusieurs elements identiques 
et que le deuxieme ensemble en contient moins, les elements residuels apres suppression seront pre- 
sents dans la difference. 

La bibliotheque standard fournit egalement un algorithme de suppression symetrique, l'algorithme 
set_symmetric_dif ference, qui construit un nouvel ensemble contenant tous les elements des 
deux ensembles qui ne se trouvent pas dans 1' autre. II s'agit en fait de 1' union des deux differences 
des deux ensembles. 

Note : Remarquez que le mot « symmetric » s'ecrit avec deux V en anglais. Ne vous etonnez 
done pas d'obtenir des erreurs de compilation si vous ecrivez set_symmetric_dif ference a la 
francaise ! 



Les algorithmes set_dif ference et set_symmetric_dif ference sont declares comme suit dans 
l'en-tete algorithm : 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator> 
Outputlterator set_dif ference ( 

Inputlteratorl premierl, Inputlteratorl dernierl, 

InputIterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination) ; 

template <class Inputlteratorl, class InputIterator2, 
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class Outputlterator, class Compare> 
Outputlterator set_dif ference ( 

Inputlteratorl premierl, Input Iteratorl dernierl, 
Input Iterator2 premier2, Input Iterator2 dernier2, 
Outputlterator destination, Compare c) ; 

template <class Inputlteratorl, class InputIterator2, class Outputlterator> 
Outputlterator set_symmetric_dif ference ( 

Inputlteratorl premier, Inputlteratorl dernier, 

InputIterator2 premier, InputIterator2 dernier2, 

Outputlterator destination) ; 

template <class Inputlteratorl, class InputIterator2, 

class Outputlterator, class Compare> 
Outputlterator set_symmetric_dif ference ( 

Inputlteratorl premierl, Inputlteratorl dernierl, 

Input Iterator2 premier2, Input Iterator2 dernier2, 

Outputlterator destination, Compare c) ; 



lis prennent tous deux paires d'iterateurs identifiant les deux ensembles dont la difference doit etre 
calculee ainsi qu'un iterateur referencant l'emplacement destination dans lequel le resultat doit etre 
place. Comme a l'accoutumee, il est possible d'indiquer le foncteur permettant a l'algorithme de rea- 
liser les tests d'inferiorite entre deux elements et selon lequel les ensembles sont tries. La complexite 
de ces algorithmes est n+m, ou n et m sont les nombres d'elements des deux ensembles sur lesquels 
les algorithmes operent. 

Exemple 18-32. Algorithmes de difference d'ensembles 

#include <iostream> 
tinclude <algorithm> 

using namespace std; 

int main (void) 
{ 

int tl[10] = {0, 1, 5, 7, 7, 7, 8, 8, 9, 10}; 

int t2[10] = {0, 2, 3, 7, 9, 11, 12, 12, 13, 14}; 

int t [20] ; 

// Calcule la difference de tl et de t2 : 

int *fin = set_dif ference (tl, tl+10, t2, t2+10, t); 

// Affiche le resultat : 

int *p = t; 

while (p != fin) 

{ 

cout << *p << " "; 

++p; 
} 

cout << endl; 

// Calcule la difference symetrique de tl et t2 : 
fin = set_symmetric_dif ference (tl, tl+10, t2, t2+10, t); 
// Affiche le resultat : 
int *p = t; 
while (p != fin) 
{ 

cout << *p << " "; 
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++p; 



cout << endl; 

// Calcule la difference symetrique de tl et t2 : 

fin = set_symmetric_dif f erence (tl, tl+10, t2, t2+10, t); 

// Affiche le resultat : 

P = t; 

while (p != fin) 

{ 

cout << *p << " "; 

++p; 
} 

cout << endl; 
return 0; 



18.5.5. Operations de partitionnement 

L'algorithme partition de la bibliotheque standard permet de separer les elements d'un ensemble 
en deux sous-ensembles selon un critere donne. Les elements verifiant ce critere sont places en tete 
de l'ensemble, et les elements qui ne le verifient pas sont places a la fin. Cet algorithme est declare 
comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class Predicate> 
Forwardlterator partition (Forwardlterator premier, 
Forwardlterator dernier, Predicate p) ; 



Les parametres qui doivent etre fournis a cet algorithme sont les iterateurs referencant le premier et 
le dernier element de l'ensemble a partitionner, ainsi qu'un foncteur unaire permettant de determiner 
si un element verifie le critere de partitionnement ou non. La valeur retournee est la position de la 
separation entre les deux sous-ensembles generes par 1'operation de partition. 

Exemple 18-33. Algorithme de partitionnement 

#include <iostream> 
#include <functional> 
tinclude <algorithm> 

using namespace std; 

bool parity_even (int i) 
{ 

return (i & 1) == 0; 



int main (void) 
{ 

int t[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}. 

// Partitionne le tableau en nombre pairs 

// et nombre impairs : 

partition (t, t + 10, ptr_f un ( &parity_even) ) ; 

// Affiche le resultat : 

int i; 
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for (i=0; i<10; ++i) 

cout << t[i] << " "; 

cout << endl; 
return 0; 
} 

La complexite de l'algorithme partition est lineaire en fonction du nombre d'elements de 
1' ensemble a partitionner. Cependant, 1' operation de partitionnement n'est pas stable, c'est-a-dire que 
l'ordre relatif des elements de meme valeur et sur lesquels le predicat du critere de partitionnement 
donne le meme resultat n'est pas conserve. La bibliotheque standard fournit done un autre 
algorithme, stable celui-la, mais qui s'execute avec une complexite legerement superieure. II s'agit 
de l'algorithme stable_partition, qui est declare comme suit dans l'en-tete algorithm : 

template <class Forwardlterator, class Predicate> 
Forwardlterator stable_partition (Forwardlterator premier, 
Forwardlterator dernier, Predicate p) ; 



Comme vous pouvez le constater, cet algorithme s' utilise exactement de la meme maniere 
que l'algorithme partition. Toutefois, il garantit l'ordre relatif des elements au sein des 
sous-ensembles generes par F operation de partitionnement. La complexite de cet algorithme est n 
s'il dispose de suffisamment de memoire, et nxin(n) dans le cas contraire (n etant la taille de 
1' ensemble a partitionner). 
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Pour terminer, je rappellerai les principales regies pour realiser de bons programmes. Sans organisa- 
tion, aucun langage, aussi puissant soit-il, ne peut garantir le succes d'un projet. Voici done quelques 
conseils : 



commentez votre code, mais ne tuez pas le commentaire en en mettant la oil les operations sont 
vraiment tres simples ou decrites dans un document externe. Marquez les references aux documents 
externes dans les commentaires ; 

analysez le probleme avant de commencer la programmation. Cela comprend plusieurs etapes. 
La premiere est de reflechir aux structures de donnees a utiliser et aux operations qu'on va leur 
appliquer (il faut done identifier les classes). II faut ensuite etablir les relations entre les classes 
ainsi identifiees et leurs communications. Pour cela, on pourra faire des diagrammes d'evenements 
qui identifient les differentes etapes du processus permettant de traiter une donnee. Enfin, on decrira 
chacune des methodes des classes fonctionnellement, afin de savoir exactement quelles sont leurs 
entrees et les domaines de validite de celles-ci, leurs sorties, leurs effets de bords et les operations 
effectuees. Enfin seulement on passera au codage. Si le codage implique de corriger les resultats des 
etapes precedentes, e'est que la conception a ete incorrecte ou incomplete : il vaut mieux retourner 
en phase de conception un peu pour voir l'impact des modifications a faire. Cela permet de ne pas 
passer a cote d'un effet de bord inattendu, et done d'eviter de perdre du temps dans la phase de 
mise au point ; 

ne considerez aucun projet, meme un petit projet ou un projet personnel, comme un projet qui 
echappe a ces regies. Si vous devez interrompre le developpement d'un projet pour une raison 
quelconque, vous serez content de retrouver le maximum d' informations sur lui. II en est de meme 
si vous desirez ameliorer un ancien projet. Et si la conception a ete bien faite, cette amelioration ne 
sera pas une verrue sur l'ancienne version du logiciel, contrairement a ce qui se passe trop souvent. 



Voila. Vous connaissez a present la plupart des fonctionnalites du C++. J'espere que la lecture de ce 
cours vous aura ete utile et agreable. Si vous voulez en savoir plus, consultez les Draft Papers, mais 
sachez qu'ils sont reellement difficiles a lire. lis ne peuvent vraiment pas etre pris pour un support de 
cours. L' annexe B decrit 1' organisation generale de ce document et donne quelques renseignements 
pour faciliter leur lecture. 

Bonne continuation... 
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Cette annexe donne la priorite des operateurs du langage C++, dans l'ordre decroissant. Cette prio- 
rite intervient dans 1' analyse de toute expression et dans la determination de son sens. Cependant, 
1' analyse des expressions peut etre modifiee en changeant les priorites a l'aide de parentheses. 

Tableau A-l. Operateurs du langage 



Operateur 


Nom ou signification 




Operateur de resolution de portee 


[] 


Operateur d'acces aux elements de tableau 





Operateur d'appel de fonction 


type () 


Operateur de transtypage explicite 




Operateur de selection de membre 


-> 


Operateur de selection de membre par dereferencement 


+ + 


Operateur decrementation post-fixe 


— 


Operateur de decrementation post-fixe 


new 


Operateur de creation dynamique d'objets 


new [ ] 


Operateur de creation dynamique de tableaux 


delete 


Operateur de destruction des objets crees dynamiquement 


delete [ ] 


Operateur de destruction des tableaux crees dynamiquement 


+ + 


Operateur decrementation prefixe 


— 


Operateur de decrementation prefixe 


* 


Operateur de dereferencement 


& 


Operateur d'adresse 


+ 


Operateur plus unaire 


- 


Operateur negation unaire 


I 


Operateur de negation logique 


~ 


Operateur de complement a un 


sizeof 


Operateur de taille d'objet 


sizeof 


Operateur de taille de type 


typeid 


Operateur d'identification de type 


(type) 


Operateur de transtypage 


const_cast 


Operateur de transtypage de Constance 


dynamic_cast 


Operateur de transtypage dynamique 


reinterpret_cast 


Operateur de reinterpretation 


static_cast 


Operateur de transtypage statique 


* 


Operateur de selection de membre par pointeur sur membre 


->* 


Operateur de selection de membre par pointeur sur membre par 
dereferencement 


■k 


Operateur de multiplication 


/ 


Operateur de division 


% 


Operateur de reste de la division entiere 
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Operateur 


Nom ou signification 


+ 


Operateur d' addition 


- 


Operateur de soustraction 


<< 


Operateur de decalage a gauche 


>> 


Operateur de decalage a droite 


< 


Operateur d'inferiorite 


> 


Operateur de superiorite 


<= 


Operateur d'inferiorite ou d'egalite 


>= 


Operateur de superiorite ou d'egalite 


== 


Operateur d'egalite 


i = 


Operateur d'inegalite 


& 


Operateur et binaire 


- 


Operateur ou exclusif binaire 




Operateur ou inclusif binaire 


&& 


Operateur et logique 


l l 


Operateur ou logique 


? ; 


Operateur ternaire 


= 


Operateur d'affectation 


* = 


Operateur de multiplication et d'affectation 


/= 


Operateur de division et d'affectation 


%= 


Operateur de modulo et d'affectation 


+= 


Operateur d' addition et d'affectation 


-= 


Operateur de soustraction et d'affectation 


<<= 


Operateur de decalage a gauche et d'affectation 


>>= 


Operateur de decalage a droite et d'affectation 


&= 


Operateur de et binaire et d'affectation 


1 = 


Operateur de ou inclusif binaire et d'affectation 


-= 


Operateur de ou exclusif binaire et d'affectation 


, 


Operateur virgule 
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Les Draft Papers sont vraiment une source d' informations tres precise, mais ils ne sont pas vraiment 
structures. En fait, ils ne sont destines qu'aux editeurs de logiciels desirant realiser un compilateur, et 
la structure du document ressemble a un texte de loi (fortement technique en prime). Les exemples y 
sont rares, et quand il y en a, on ne sait pas a quel paragraphe ils se referent. Enfin, nombre de termes 
non definis sont utilises, et il faut lire le document pendant quelques 40 pages avant de commencer a 
le comprendre. 

Afin de faciliter leur lecture, je donne ici quelques definitions, ainsi que la structure des Draft Papers. 

Les Draft Papers sont constitues de deux grandes parties. La premiere traite du langage, de sa syntaxe 
et de sa semantique. La deuxieme partie decrit la bibliotheque standard C++. 

La syntaxe est decrite dans la premiere partie de la maniere BNF. II vaut mieux etre familiarise avec 
cette forme de description pour la comprendre. Cela ne causera pas de probleme cependant si Ton 
maitrise deja la syntaxe du C++. 

Lors de la lecture de la deuxieme partie, on ne s'attardera pas trop sur les fonctionnalites de gestion 
des langues et des jeux de caracteres (locales). Elles ne sont pas necessaires a la comprehension de la 
bibliotheque standard. Une fois les grands principes de la bibliotheque assimiles, les notions de locale 
pourront etre approfondies. 

Les termes suivants sont souvent utilises et non definis (ou definis au milieu du document d'une 
maniere peu claire). Leurs definitions pourront etre d'un grand secours lors de lecture de la premiere 
partie des Draft Papers : 

cv, cv qualified : l'abreviation cv signifie ici const ou volatile. Ce sont done les proprietes de 
Constance et de volatilite ; 

• un agregat est un tableau ou une classe qui n'a pas de constructeurs, pas de fonctions virtuelles, et 
pas de donnee non statique private ou protected ; 

• POD : cette abreviation signifie plain ol' data, ce qui n'est pas comprehensible a priori. En fait, un 
type POD est un type relativement simple, pour lequel aucun traitement particulier n'est necessaire 
(pas de constructeur, pas de virtualite, etc.). La definition des types POD est recursive : une structure 
ou une union est un type POD si e'est un agregat qui ne contient pas de pointeur sur un membre non 
statique, pas de reference, pas de type non POD, pas de constructeur de copie et pas de destructeur. 



Les autres termes sont definis lorsqu'ils apparaissent pour la premiere fois dans le document. 
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License 

Version 1.1, March 2000 

Copyright (C) 2000 Free Software Foundation, Inc. 

59 Temple Place, Suite 330, Boston, MA 021 1 1-1307 USA 

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing 
it is not allowed. 

0. PREAMBLE 

The purpose of this License is to make a manual, textbook, or other written document "free" in the 
sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without 
modifying it, either commercially or noncommercially. Secondarily, this License preserves for the 
author and publisher a way to get credit for their work, while not being considered responsible for 
modifications made by others. 

This License is a kind of "copyleft", which means that derivative works of the document must them- 
selves be free in the same sense. It complements the GNU General Public License, which is a copyleft 
license designed for free software. 

We have designed this License in order to use it for manuals for free software, because free software 
needs free documentation: a free program should come with manuals providing the same freedoms 
that the software does. But this License is not limited to software manuals; it can be used for any 
textual work, regardless of subject matter or whether it is published as a printed book. We recommend 
this License principally for works whose purpose is instruction or reference. 

1. APPLICABILITY AND DEFINITIONS 

This License applies to any manual or other work that contains a notice placed by the copyright holder 
saying it can be distributed under the terms of this License. The "Document", below, refers to any such 
manual or work. Any member of the public is a licensee, and is addressed as "you". 

A "Modified Version" of the Document means any work containing the Document or a portion of it, 
either copied verbatim, or with modifications and/or translated into another language. 

A "Secondary Section" is a named appendix or a front-matter section of the Document that deals 
exclusively with the relationship of the publishers or authors of the Document to the Document's 
overall subject (or to related matters) and contains nothing that could fall directly within that overall 
subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section 
may not explain any mathematics.) The relationship could be a matter of historical connection with 
the subject or with related matters, or of legal, commercial, philosophical, ethical or political position 
regarding them. 

The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of 
Invariant Sections, in the notice that says that the Document is released under this License. 

The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back- 
Cover Texts, in the notice that says that the Document is released under this License. 

A "Transparent" copy of the Document means a machine-readable copy, represented in a format 
whose specification is available to the general public, whose contents can be viewed and edited di- 
rectly and straightforwardly with generic text editors or (for images composed of pixels) generic paint 
programs or (for drawings) some widely available drawing editor, and that is suitable for input to text 
formatters or for automatic translation to a variety of formats suitable for input to text formatters. 
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A copy made in an otherwise Transparent file format whose markup has been designed to thwart or 
discourage subsequent modification by readers is not Transparent. A copy that is not "Transparent" is 
called "Opaque". 

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo 
input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard- 
conforming simple HTML designed for human modification. Opaque formats include PostScript, 
PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML 
or XML for which the DTD and/or processing tools are not generally available, and the machine- 
generated HTML produced by some word processors for output purposes only. 

The "Title Page" means, for a printed book, the title page itself, plus such following pages as are 
needed to hold, legibly, the material this License requires to appear in the title page. For works in 
formats which do not have any title page as such, "Title Page" means the text near the most prominent 
appearance of the work's title, preceding the beginning of the body of the text. 

2. VERBATIM COPYING 

You may copy and distribute the Document in any medium, either commercially or noncommercially, 
provided that this License, the copyright notices, and the license notice saying this License applies 
to the Document are reproduced in all copies, and that you add no other conditions whatsoever to 
those of this License. You may not use technical measures to obstruct or control the reading or further 
copying of the copies you make or distribute. However, you may accept compensation in exchange 
for copies. If you distribute a large enough number of copies you must also follow the conditions in 
section 3. 

You may also lend copies, under the same conditions stated above, and you may publicly display 
copies. 

3. COPYING IN QUANTITY 

If you publish printed copies of the Document numbering more than 100, and the Document's license 
notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all 
these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. 
Both covers must also clearly and legibly identify you as the publisher of these copies. The front 
cover must present the full title with all words of the title equally prominent and visible. You may add 
other material on the covers in addition. Copying with changes limited to the covers, as long as they 
preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in 
other respects. 

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones 
listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages. 

If you publish or distribute Opaque copies of the Document numbering more than 100, you must either 
include a machine-readable Transparent copy along with each Opaque copy, or state in or with each 
Opaque copy a publicly-accessible computer-network location containing a complete Transparent 
copy of the Document, free of added material, which the general network-using public has access to 
download anonymously at no charge using public-standard network protocols. If you use the latter 
option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in 
quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until 
at least one year after the last time you distribute an Opaque copy (directly or through your agents or 
retailers) of that edition to the public. 

It is requested, but not required, that you contact the authors of the Document well before redistribut- 
ing any large number of copies, to give them a chance to provide you with an updated version of the 
Document. 

4. MODIFICATIONS 
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You may copy and distribute a Modified Version of the Document under the conditions of sections 
2 and 3 above, provided that you release the Modified Version under precisely this License, with the 
Modified Version filling the role of the Document, thus licensing distribution and modification of 
the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the 
Modified Version: 

A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and 
from those of previous versions (which should, if there were any, be listed in the History section 
of the Document). You may use the same title as a previous version if the original publisher of 
that version gives permission. 

B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of 
the modifications in the Modified Version, together with at least five of the principal authors of 
the Document (all of its principal authors, if it has less than five). 

C. State on the Title page the name of the publisher of the Modified Version, as the publisher. 

D. Preserve all the copyright notices of the Document. 

E. Add an appropriate copyright notice for your modifications adjacent to the other copyright no- 
tices. 

F. Include, immediately after the copyright notices, a license notice giving the public permission 
to use the Modified Version under the terms of this License, in the form shown in the Addendum 
below. 

G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given 
in the Document's license notice. 

H. Include an unaltered copy of this License. 

I. Preserve the section entitled "History", and its title, and add to it an item stating at least the 
title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there 
is no section entitled "History" in the Document, create one stating the title, year, authors, and 
publisher of the Document as given on its Title Page, then add an item describing the Modified 
Version as stated in the previous sentence. 

J. Preserve the network location, if any, given in the Document for public access to a Transparent 
copy of the Document, and likewise the network locations given in the Document for previous 
versions it was based on. These may be placed in the "History" section. You may omit a network 
location for a work that was published at least four years before the Document itself, or if the 
original publisher of the version it refers to gives permission. 

K. In any section entitled "Acknowledgements" or "Dedications", preserve the section's title, and 
preserve in the section all the substance and tone of each of the contributor acknowledgements 
and/or dedications given therein. 

L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. 
Section numbers or the equivalent are not considered part of the section titles. 

M. Delete any section entitled "Endorsements". Such a section may not be included in the Modified 
Version. 

N. Do not retitle any existing section as "Endorsements" or to conflict in title with any Invariant 
Section. 



If the Modified Version includes new front-matter sections or appendices that qualify as Secondary 
Sections and contain no material copied from the Document, you may at your option designate some 
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or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the 
Modified Version's license notice. These titles must be distinct from any other section titles. 

You may add a section entitled "Endorsements", provided it contains nothing but endorsements of 
your Modified Version by various parties— for example, statements of peer review or that the text has 
been approved by an organization as the authoritative definition of a standard. 

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as 
a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of 
Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) 
any one entity. If the Document already includes a cover text for the same cover, previously added by 
you or by arrangement made by the same entity you are acting on behalf of, you may not add another; 
but you may replace the old one, on explicit permission from the previous publisher that added the 
old one. 

The author(s) and publisher(s) of the Document do not by this License give permission to use their 
names for publicity for or to assert or imply endorsement of any Modified Version. 

5. COMBINING DOCUMENTS 

You may combine the Document with other documents released under this License, under the terms 
defined in section 4 above for modified versions, provided that you include in the combination all 
of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant 
Sections of your combined work in its license notice. 

The combined work need only contain one copy of this License, and multiple identical Invariant 
Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same 
name but different contents, make the title of each such section unique by adding at the end of it, in 
parentheses, the name of the original author or publisher of that section if known, or else a unique 
number. Make the same adjustment to the section titles in the list of Invariant Sections in the license 
notice of the combined work. 

In the combination, you must combine any sections entitled "History" in the various original docu- 
ments, forming one section entitled "History"; likewise combine any sections entitled "Acknowledge- 
ments", and any sections entitled "Dedications". You must delete all sections entitled "Endorsements." 

6. COLLECTIONS OF DOCUMENTS 

You may make a collection consisting of the Document and other documents released under this 
License, and replace the individual copies of this License in the various documents with a single 
copy that is included in the collection, provided that you follow the rules of this License for verbatim 
copying of each of the documents in all other respects. 

You may extract a single document from such a collection, and distribute it individually under this 
License, provided you insert a copy of this License into the extracted document, and follow this 
License in all other respects regarding verbatim copying of that document. 

7. AGGREGATION WITH INDEPENDENT WORKS 

A compilation of the Document or its derivatives with other separate and independent documents or 
works, in or on a volume of a storage or distribution medium, does not as a whole count as a Modified 
Version of the Document, provided no compilation copyright is claimed for the compilation. Such a 
compilation is called an "aggregate", and this License does not apply to the other self-contained works 
thus compiled with the Document, on account of their being thus compiled, if they are not themselves 
derivative works of the Document. 

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the 
Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed 
on covers that surround only the Document within the aggregate. Otherwise they must appear on 
covers around the whole aggregate. 
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8. TRANSLATION 



Translation is considered a kind of modification, so you may distribute translations of the Document 
under the terms of section 4. Replacing Invariant Sections with translations requires special permis- 
sion from their copyright holders, but you may include translations of some or all Invariant Sections 
in addition to the original versions of these Invariant Sections. You may include a translation of this 
License provided that you also include the original English version of this License. In case of a 
disagreement between the translation and the original English version of this License, the original 
English version will prevail. 

9. TERMINATION 

You may not copy, modify, sublicense, or distribute the Document except as expressly provided for 
under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, 
and will automatically terminate your rights under this License. However, parties who have received 
copies, or rights, from you under this License will not have their licenses terminated so long as such 
parties remain in full compliance. 

10. FUTURE REVISIONS OF THIS LICENSE 

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation 
License from time to time. Such new versions will be similar in spirit to the present version, but may 
differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. 

Each version of the License is given a distinguishing version number. If the Document specifies that 
a particular numbered version of this License "or any later version" applies to it, you have the option 
of following the terms and conditions either of that specified version or of any later version that has 
been published (not as a draft) by the Free Software Foundation. If the Document does not specify 
a version number of this License, you may choose any version ever published (not as a draft) by the 
Free Software Foundation. 
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GNU 

Disclaimer 

This is an unofficial translation of the GNU Free Documentation License into French. It was not pu- 
blished by the Free Software Foundation, and does not legally state the distribution terms for software 
that uses the GNU FDL— only the original English text of the GNU FDL does that. However, we hope 
that this translation will help French speakers understand the GNU FDL better. 

Ceci est une traduction francaise non officielle de la Licence de documentation libre GNU. Elle n' a pas 
ete publiee par la Free Software Foundation, et ne fixe pas legalement les conditions de redistribution 
des documents qui l'utilisent — seul le texte original en anglais le fait. Nous esperons toutefois que 
cette traduction aidera les francophones a mieux comprendre la FDL GNU. 

Traduction francaise non officielle de la GFDL Version 1 . 1 (Mars 2000) 

Copyright original : 

Copyright (C) 2000 Free Sofware Foundation, inc 

59 Temple Place, Suite 330, Boston, MA 021 1 1-1307 USA 

Pour la traduction : 

Version 1.0 FR (Jean Luc Fortin, juillet 2000) 

Version 1.1 FR (Christian Casteyde, mars 2001) 

Version 1.1.1 FR (Cesar Alexanian, mars 2001) 

Version 1.1.2 FR (Christian Casteyde et Cesar Alexanian, mars 2001) 

Version 1.1.3 FR (Christian Casteyde, avril 2001) 

Chacun est libre de copier et de distribuer des copies conformes de cette Licence, mais nul n'est 
autorise a la modifier. 

- PREAMBULE 

L'objet de cette Licence est de rendre tout manuel, livre ou autre document ecrit « libre » au sens de 
la liberte d' utilisation, a savoir : assurer a chacun la liberie effective de le copier ou de le redistribuer, 
avec ou sans modifications, commercialement ou non. En outre, cette Licence garantit a l'auteur et a 
l'editeur la reconnaissance de leur travail, sans qu'ils soient pour autant considered comme respon- 
sables des modifications realisees par des tiers. 

Cette Licence est une sorte de « copyleft », ce qui signifie que les travaux derives du document 
d'origine sont eux-memes « libres » selon les memes termes. Elle complete la Licence Publique 
Generate GNU, qui est egalement une Licence copyleft, concue pour les logiciels libres. 

Nous avons concu cette Licence pour la documentation des logiciels libres, car les logiciels libres 
ont besoin d'une documentation elle-meme libre : un logiciel libre doit etre accompagne d'un manuel 
garantissant les memes libertes que celles accordees par le logiciel lui-meme. Mais cette Licence n'est 
pas limitee aux seuls manuels des logiciels ; elle peut etre utilisee pour tous les documents ecrits, sans 
distinction particuliere relative au sujet traite ou au mode de publication. Nous recommandons 1' usage 
de cette Licence principalement pour les travaux destines a des fins d'enseignement ou devant servir 
de documents de reference. 

1 - APPLICABILITY ET DEFINITIONS 
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Cette Licence couvre tout manuel ou tout autre travail ecrit contenant une notice de copyright autori- 
sant la redistribution selon les termes de cette Licence. Le mot « Document » se refere ci-apres a un 
tel manuel ou travail. Toute personne en est par definition concessionnaire, et est referencee ci-apres 
par le terme « Vous ». 

Une « Version modifiee » du Document designe tout travail en contenant la totalite ou seulement une 
portion de celui-ci, copiee mot pour mot, modifiee et/ou traduite dans une autre langue. 

Une « Section secondaire » designe une annexe au Document, ou toute information indiquant les 
rapports entre l'auteur ou l'editeur et le sujet (ou tout autre sujet connexe) du document, sans tou- 
tefois etre en rapport direct avec le sujet lui-meme (par exemple, si le Document est un manuel de 
mathematiques, une Section secondaire ne traitera d'aucune notion mathematique). Cette section peut 
contenir des informations relatives a l'historique du Document, des sources documentaires, des dis- 
positions legales, commerciales, philosophiques, ou des positions ethiques ou politiques susceptibles 
de concerner le sujet traite. 

Les « Sections inalterables » sont des sections secondaries considerees comme ne pouvant etre modi- 
fiees et citees comme telles dans la notice legale qui place le Document sous cette Licence. 

Les « Textes de couverture » sont les textes courts situes sur les pages de couverture avant et arriere 
du Document, et cites comme tels dans la mention legale de ce Document. 

Le terme « Copie transparente » designe une version numerique du Document representee dans un 
format dont les specifications sont publiquement disponibles et dont le contenu peut etre visualise et 
edite directement et immediatement par un editeur de texte quelconque, ou (pour les images compo- 
sees de pixels) par un programme de traitement d' images quelconque, ou (pour les dessins) par un 
editeur de dessins courant. Ce format doit etre pouvoir etre accepte directement ou etre convertible 
facilement dans des formats utilisables directement par des logiciels de formatage de texte. Une copie 
publiee dans un quelconque format numerique ouvert mais dont la structure a ete concue dans le but 
expres de prevenir les modifications ulterieures du Document ou dans le but d'en decourager les lec- 
teurs n'est pas consideree comme une Copie Transparente. Une copie qui n'est pas « Transparente » 
est consideree, par opposition, comme « Opaque ». 

Le format de fichier texte code en ASCII generique et n'utilisant pas de balises, les formats de fi- 
chiers Texinfo ou LaTeX, les formats de fichiers SGML ou XML utilisant une DTD publiquement 
accessible, ainsi que les formats de fichiers HTML simple et standard, ecrits de telle sorte qu'ils 
sont modifiables sans outil specifique, sont des exemples de formats acceptables pour la realisation 
de Copies Transparentes. Les formats suivants sont opaques : PostScript, PDF, formats de fichiers 
proprietaries qui ne peuvent etre visualises ou edites que par des traitements de textes proprietaries, 
SGML et XML utilisant des DTD et/ou des outils de formatage qui ne sont pas disponibles publique- 
ment, et du code HTML genere par une machine a l'aide d'un traitement de texte quelconque et dans 
le seul but de la generation d'un format de sortie. 

La « Page de titre » designe, pour les ouvrages imprimes, la page de titre elle-meme, ainsi que les 
pages supplementaires necessaries pour fournir clairement les informations dont cette Licence impose 
la presence sur la page de titre. Pour les travaux n'ayant pas de Page de titre comme decrit ci-dessus, 
la « Page de titre » designe le texte qui s'apparente le plus au titre du document et situe avant le texte 
principal. 

2 - COPIES CONFORMES 

Vous pouvez copier et distribuer le Document sur tout type de support, commercialement ou non, 
a condition que cette Licence, la notice de copyright et la notice de la Licence indiquant que cette 
Licence s' applique a ce Document soient reproduits dans toutes les copies, et que vous n'y ajoutiez 
aucune condition restrictive supplementaire. Vous ne pouvez pas utiliser un quelconque moyen tech- 
nique visant a empecher ou a controler la lecture ou la reproduction ulterieure des copies que vous 
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avez creees ou distributes. Toutefois, vous pouvez sollicker une retribution en echange des copies. Si 
vous distribuez une grande quantite de copies, referez-vous aux dispositions de la section 3. 

Vous pouvez egalement preter des copies, sous les memes conditions que celles precitees, et vous 
pouvez afficher publiquement des copies de ce Document. 

3 - COPIES EN NOMBRE 

Si vous publiez des copies imprimees de ce Document a plus de 100 exemplaires, et que la Licence 
du Document indique la presence de Textes de couverture, vous devez fournir une couverture pour 
chaque copie, qui presente les Textes de couverture des premiere et derniere pages de couverture du 
Document. Les premiere et derniere pages de couverture doivent egalement vous identifier clairement 
et sans ambiguite comme etant l'editeur de ces copies. La premiere page de couverture doit comporter 
le titre du Document en mots d'importance et de visibilite egale. Vous pouvez ajouter des informations 
complementaires sur les pages de couverture. Les copies du Document dont seule la couverture a ete 
modifiee peuvent etre considerees comme des copies conformes, a condition que le titre du Document 
soit preserve et que les conditions indiquees precedemment soient respectees. 

Si les textes devant se trouver sur la couverture sont trop importants pour y tenir de maniere claire, 
vous pouvez ne placer que les premiers sur la premiere page et placer les suivants sur les pages 
consecutives. 

Si vous publiez plus de 100 Copies opaques du Document, vous devez soit fournir une Copie trans- 
parente pour chaque Copie opaque, soit preciser ou fournir avec chaque Copie opaque une adresse 
reseau publiquement accessible d'une Copie transparente et complete du Document, sans aucun ajout 
ou modification, et a laquelle tout le monde peut acceder en telechargement anonyme et sans frais, 
selon des protocoles reseau communs et standards. Si vous choisissez cette derniere option, vous de- 
vez prendre les dispositions necessaires, dans la limite du raisonnable, afin de garantir l'acces non 
restrictif a la Copie transparente durant une annee pleine apres la diffusion publique de la derniere 
Copie opaque (directement ou via vos revendeurs). 

Nous recommandons, mais ce n'est pas obligatoire, que vous contactiez l'auteur du Document suf- 
fisamment tot avant toute publication d'un grand nombre de copies, afin de lui permettre de vous 
donner une version a jour du Document. 

4 - MODIFICATIONS 

Vous pouvez copier et distribuer une Version modifiee du Document en respectant les conditions des 
sections 2 et 3 precedentes, a condition de placer cette Version modifiee sous la presente Licence, 
dans laquelle le terme « Document » doit etre remplace par les termes « Version modifiee », donnant 
ainsi l'autorisation de redistribuer et de modifier cette Version modifiee a quiconque en possede une 
copie. De plus, vous devez effectuer les actions suivantes dans la Version modifiee : 

A. Utiliser sur la Page de titre (et sur la page de couverture eventuellement presente) un titre distinct 
de celui du Document d'origine et de toutes ses versions anterieures (qui, si elles existent, doivent 
etre mentionnees dans la section « Historique » du Document). Vous pouvez utiliser le meme titre 
si l'editeur d'origine vous en a donne expressement la permission. 

B. Mentionner sur la Page de titre en tant qu'auteurs une ou plusieurs des personnes ou entites 
responsables des modifications de la Version modifiee, avec au moins les cinq principaux auteurs 
du Document (ou tous les auteurs si il y en a moins de cinq). 

C. Preciser sur la Page de titre le nom de l'editeur de la Version modifiee, en tant qu'editeur du 
Document. 

D. Preserver integralement toutes les notices de copyright du Document. 

E. Ajouter une notice de copyright adjacente aux autres notices pour vos propres modifications. 
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F. Inclure immediatement apres les notices de copyright une notice donnant a quiconque 
l'autorisation d'utiliser la Version modifiee selon les termes de cette Licence, sous la forme 
presentee dans 1' annexe indiquee ci-dessous. 

G. Preserver dans cette notice la liste complete des Sections inalterables et les Textes de couverture 
donnes avec la notice de la Licence du Document. 

H. Inclure une copie non modifiee de cette Licence. 

I. Preserver la section nominee « Historique » et son titre, et y ajouter une nouvelle entree decrivant 
le titre, l'annee, les nouveaux auteurs et l'editeur de la Version modifiee, tels que decrits sur la 
Page de titre, ainsi qu'un descriptif des modifications apportees depuis la precedente version. 

J. Conserver l'adresse reseau eventuellement indiquee dans le Document permettant a quiconque 
d'acceder a une Copie transparente du Document, ainsi que les adresses reseau indiquees dans le 
Document pour les versions precedentes sur lesquelles le Document se base. Ces liens peuvent 
etre places dans la section « Historique ». Vous pouvez ne pas conserver les liens pour un travail 
datant de plus de quatre ans avant la version courante ou si l'editeur d'origine vous en accorde la 
permission. 

K. Si une section « Dedicaces » ou une section « Remerciements » sont presentes, les informa- 
tions et les appreciations concernant les contributeurs et les personnes auxquelles s'adressent ces 
remerciements doivent etre conservees, ainsi que le titre de ces sections. 

L. Conserver sans modification les Sections inalterables du Document, ni dans leurs textes, ni dans 
leurs titres. Les numeros de sections ne sont pas considered comme faisant partie du texte des 
sections. 

M. Effacer toute section intitulee « Approbations ». Une telle section ne peut pas etre incluse dans 
une Version modifiee. 

N. Ne pas renommer une section existante sous le titre « Approbations » ou sous un autre titre 
entrant en confiit avec le titre d'une Section inalterable. 



Si la Version modifiee contient de nouvelles sections preliminaires ou de nouvelles annexes conside- 
rees comme des Sections secondaires, et que celles-ci ne contiennent aucun element copie depuis le 
Document, vous pouvez a votre convenance en designer une ou plusieurs comme etant des Sections 
inalterables. Pour ce faire, ajoutez leurs titres dans la liste des Sections inalterables au sein de la notice 
de Licence de la Version modifiee. Ces titres doivent etres distincts des titres des autres sections. 

Vous pouvez ajouter une section nommee « Approbations », a condition que ces approbations ne 
concernent que les modifications ayant donne naissance a la Version modifiee (par exemple, comptes- 
rendus de revue de document, ou acceptation du texte par une organisation le reconnaissant comme 
etant la definition d'un standard). 

Vous pouvez ajouter un passage comprenant jusqu'a cinq mots en premiere page de couverture, et 
jusqu'a vingt-cinq mots en derniere page de couverture, a la liste des Textes de couverture de la 
Version modifiee. II n'est autorise d'ajouter qu'un seul passage en premiere et en derniere page de 
couverture par personne ou groupe de personnes ou organisation ayant contribue a la modification du 
Document. Si le Document comporte deja un passage sur la meme couverture, ajoute en votre nom 
ou au nom de 1'organisation au nom de laquelle vous agissez, vous ne pouvez pas ajouter de passage 
supplemental ; mais vous pouvez remplacer un ancien passage si vous avez expressement obtenu 
l'autorisation de l'editeur de celui-ci. 

Cette Licence ne vous donne pas le droit d'utiliser le nom des auteurs et des editeurs de ce Document 
a des fins publicitaires ou pour pretendre a l'approbation d'une Version modifiee. 

5 - FUSION DE DOCUMENTS 
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Vous pouvez fusionner le Document avec d'autres documents soumis a cette Licence, suivant les 
specifications de la section 4 pour les Versions modifiees, a condition d'inclure dans le document 
resultant toutes les Sections inalterables des documents originaux sans modification, et de toutes les 
lister dans la liste des Sections inalterables de la notice de Licence du document resultant de la fusion. 

Le document resultant de la fusion n'a besoin que d'une seule copie de cette Licence, et les Sections 
inalterables existant en multiples exemplaires peuvent etre remplacees par une copie unique. S'il 
existe plusieurs Sections inalterables portant le meme nom mais de contenu different, rendez unique 
le titre de chaque section en ajoutant, a la fin de celui-ci, entre parentheses, le nom de l'auteur ou de 
l'editeur d'origine, ou, a defaut, un numero unique. Les memes modifications doivent etre realisees 
dans la liste des Sections inalterables de la notice de Licence du document final. 

Dans le document resultant de la fusion, vous devez rassembler en une seule toutes les 
sections « Historique » des documents d'origine. De meme, vous devez rassembler les sections 
« Remerciements » et « Dedicaces ». Vous devez supprimer toutes les sections « Approbations ». 

6 - REGROUPEMENTS DE DOCUMENTS 

Vous pouvez creer un regroupement de documents comprenant le Document et d'autres documents 
soumis a cette Licence, et remplacer les copies individuelles de cette Licence des differents documents 
par une unique copie incluse dans le regroupement de documents, a condition de respecter pour cha- 
cun de ces documents l'ensemble des regies de cette Licence concernant les copies conformes. 

Vous pouvez extraire un document d'un tel regroupement, et le distribuer individuellement sous cou- 
vert de cette Licence, a condition d'y inclure une copie de cette Licence et de l'ensemble des regies 
concernant les copies conformes. 

7 - AGREGATION AVEC DES TRAVAUX INDEPENDANTS 

La compilation du Document ou ses derives avec d'autres documents ou travaux separes et indepen- 
dants sur un support de stockage ou sur un media de distribution quelconque ne represente pas une 
Version modifiee du Document tant qu'aucun copyright n'est depose pour cette compilation. Une telle 
compilation est appelee « agregat », et cette Licence ne s'applique pas aux autres travaux indepen- 
dants compiles avec le Document, s'ils ne sont pas eux-memes des travaux derives du Document. 

Si les exigences de la section 3 concernant les Textes de couverture sont applicables a ces copies du 
Document, et si le Document represente un volume inferieur a un quart du volume total de 1' agregat, 
les Textes de couverture du Document peuvent etre places sur des pages de couverture qui n'encadrent 
que le Document au sein de F agregat. Dans le cas contraire, ils doivent apparaitre sur les pages de 
couverture de 1' agregat complet. 

8 - TRADUCTION 

La traduction est consideree comme une forme de modification, vous pouvez done distribuer les tra- 
ductions du Document selon les termes de la section 4. Vous devez obtenir l'autorisation speciale des 
auteurs des Sections inalterables pour les remplacer par des traductions, mais vous pouvez inclure 
les traductions des Sections inalterables en plus des textes originaux. Vous pouvez inclure une tra- 
duction de cette Licence a condition d'inclure egalement la version originale en anglais. En cas de 
contradiction entre la traduction et la version originale en anglais, e'est cette derniere qui prevaut. 

9 - REVOCATION 

Vous ne pouvez pas copier, modifier, sous-licencier ou distribuer le Document autrement que selon 
les termes de cette Licence. Tout autre acte de copie, modification, sous-licence ou distribution du 
Document est sans objet et vous prive automatiquement des droits que cette Licence vous accorde. 
En revanche, les personnes qui ont recu de votre part des copies ou les droits sur le document sous 
couvert de cette Licence ne voient pas leurs droits caducs tant qu'elles en respectent les principes. 

10 - REVISIONS FUTURES DE CETTE LICENCE 



443 



Annexe D. Licence de documentation libre GNU 

La Free Software Foundation peut publier de temps en temps de nouvelles versions revisees de 
cette Licence. Ces nouvelles versions seront semblables a la presente version dans l'esprit, mais 
pourront differer sur des points de detail en fonction de nouvelles questions ou problemes. Voyez 
http://www.gnu.org/copyleft/ pour plus de details. 

Chaque version de cette Licence est dotee d'un numero de version distinct. Si un Document specifie un 
numero de version particulier de cette Licence, et porte la mention « ou toute autre version ulterieure », 
vous pouvez choisir de suivre les termes de la version specifiee ou ceux de n'importe quelle version 
ulterieure publiee par la Free Software Foundation. Si aucun numero de version n'est specifie, vous 
pouvez choisir n'importe quelle version officielle publiee par la Free Sofware Foundation. 
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